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Preface 



This manual contains information you need to write C programs for the Macintosh™ by developing, 
compiling, and linking your programs under the Lisa® Workshop. Workshop C consists of a C compiler 
developed by Green HUls Software, the Standard C Library, and the Macintosh Interface Libraries. 

Contents of this Manual 

This manual contains the following sections: 

Section 1 ... a definition of the Workshop C Language. 

Section 2. . . a clarification of implementation-specific details of the language definition. 

Section 3... notes describing calling conventions and other implementation issues. 

Section 4... details on how to run the compiler, including a list of compiler options. 

Section 5. .. a list of library files and notes on when to link with each file. 

Section 6. . . a complete definition of the Standard C Library provided with Workshop C. 

Section 7. ..the C definition of the Macintosh Interface Libraries. 

Section 8 ... a combined index to the Standard C Library and the Macintosh Interface Libraries. 

Reference Materials 

You'll need to be familiar with these additional reference materials: 

• Lisa Workshop User's Guide, Pascal Workshop 3.0, Apple Computer Inc. 

• The C Programming Language, Kemighan and Ritchie (Prentice-Hall, 1978). 

• Inside Macintosh. 

• Apple Numerics Manual. 

• "Putting Together A Macintosh Application," Macintosh Software Supplement, Apple 
Computer Inc. 

Inside Macintosh and the Apple Numerics Manual will be published by Addison-Wesley in late 
1985. A preliminary, promotional edition of Inside Macintosh is currently available from Apple 
Computer. The contents of the Apple Numerics Manual are available in the "Standard Apple Numeric 
Environment" manual in the Lisa Systems Software binder of the Pascal Workshop 3.0 documentation. 



Page 1 



Installation Notes 

Lisa Workshop C is intended for use with the May 1985 Macintosh Software Supplement, which includes 
the Lisa Workshop 3.9. The files listed below are on the Workshop C release disks. They may be used 
directly or copied to a hard disk. 



Compiler 




compiler 


c.obj Version 1.8 


Macintosh Sample Program 




make file 
source 
resource file 


mac/c/make.text 

mac/c/sample/qdsample.c.text 

mac/c/sample/qdsample.r.text 


Macintosh Libraries 




headers 
objects 


mac/c/include/... .h.text 
mac/c/lib/... ,obj 
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1. The Workshop C Language 

Workshop C is a complete implementation of the C programming language. The C Programming 
Language by Kemighan and Ritchie (Prentice-Hall, 1978) is currently the most authoritative written 
definition of C. However, the language has changed in several ways since the book was written. In 
addition, numerous details of the language definition are open to interpretation. Therefore, the de facto 
standard definition of C differs in several ways from the language originally defined by Kemighan and 
Ritchie. This de facto standard is loosely defined by the Portable C Compiler (PCC), the most widely used 
implementation of C. 

Standard C is our name for the de facto standard definition of C as defined and implemented by the 
Berkeley 4.2 BSD VAX implementation of PCC, including the documented Westem Electric extensions. 
Workshop C is based on this de facto standard (not on the proposed ANSI standard currentiy under 
development). 

In addition, Apple has extended the standard language definition in several ways to facilitate writing 
programs for the Macintosh. Workshop C includes type void, enumeration data types, structure function 
parameters and results, enumeration data types, and a function modifier that allows calls to and from Pascal 
programs and the Macintosh Interface Libraries. The language has built-in support for the Standard Apple 
Numeric Environment (SANE). It recognizes the SANE data types, uses SM^ for all C floating-point 
operations and conversions, and coixecdy handles NaNs (Not-a-Number) and infinities in comparisons and in 
ASCII-binaiy conversions. The language together with the SANE library support comprise a scrupulously 
conforming implementation of extended-precision IEEE Standard 754 floating-point arithmetic. 
Furthermore, source programs written using only float and double types and standard C operations compile 
and nm without modification. These and other extensions are discussed in detail below. 



1.1 Data Types 

The table below lists the arithmetic and pointer types available in Workshop C, and the number of bits 
allocated for variables of these types. Types int and longint, which are identical in this implementation, 
represent 32-bit integers. Pointers also require 32 bits. Enumeration types are allocated either 8, 16, or 32 
bits, depending on the range of the enumeration literal values. 



DataTvpe 


Bits 


Description 


char 


8 


range -128 to 127 


unsigned char 


8 


range to 255 


short 


16 


range -32,768 to 32,767 


unsigned short 


16 


range to 65,535 


int 


32 


range -2,147,483,648 to 2,147,483,647 
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1.2 



unsigned 


int 


32 


long 




32 


unsigned long 


32 


enum 




8, 16 or 32 


* 




32 


float 




32 


double 




64 


comp 




64 


extended 




80 


Type 


Void 





range to 4,294,967,295 

range -2,147,483,648 to 2,147,483,647 

range to 4,294,967,295 

depends on the range of the enumeration literals 

pointer types 

IEEE single-precision floating point 

IEEE double-precision floating point 

SANE signed integral values 

IEEE extended-precision floating point 



Type void has no values and no operators. Type void may be used as a type specifier in function 
declarations to indicate that the function has no meaningful return value. Specifying type void in Pascal- 
compatible function declarations reduces the number of instructions generated in calling the function. (See 
Section 1.10, Pascal-Compatible Functions.) 

1.3 Type Enum 

Type enum is a type analogous to the enumeration types of Pascal. Its syntax is similar to that of the 
struct and union declarations: 

enum-specifier : 

enum { enum-list } 

enum identifier { enum-list } 

enum identifier 

enum-list: 

enumeration-declaration 
enumeration-declaration , enum-list 

enumeration-declaration', 
identifier 
identifier = constant-expression 

The first identifier in enum-specifier, like the structure tag in a struct-specifier, names a particular 
enumeration. For example, 

enum color {chartreuse, burgundy, claret, winedark}; 

enum color *cp, col; 

This enumeration makes color the enumeration tag of a type describing various colors and then declares cp 
as a pointer to an object of that type and col as an object of that type. 

The identifiers in enum-list are declared as constants and may appear wherever constants are required. If 
no enumerators with a constant-expression appear, the values of the constants begin at and increase 
by 1 as the declaration is read from left to right. An enumerator with a constant-expression gives the 
associated identifier the value indicated; subsequent identifiers continue the progression by 1 from the 
assigned value. 

Enumeration tags and constants must be unique. They are drawn fi-om the set of ordinary identifiers, unlike 
structure tags and members. Objects of a given enumeration type have a type distmct fi-om objects of all 
other types. 
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1.4 Register Variables 

The compiler allocates automatic variables in registers whenever possible. Register variables will be 
assigned to registers before other automatic variables. Enumeration, character, integer, and pointer variables 
qualify for register allocation unless their address is taken with the & operator. Floating-point variables are 
not allocated to registers. 

Several data and address registers are available for use as automatic variables. The exact number depends on 
the calling conventions being used. The number of variables allocated to registers may exceed the total 
number of registers. Several variables whose useful lifetimes do not overlap may be assigned to the same 
register. Often all of the eligible variables within a function will reside in registers, rather than on the 
stack. 



1.5 Structures 

Structures may be assigned, passed as parameters, and returned as function results. The left and right sides 
of a structure assignment must have the same type. Similiarly, actual and formal parameters must have 
identical types. Other plausible operators, such as equality comparison, have not been implemented. 

Waming: In functions that return structures, if an interrupt occurs during the return sequence and the same 
function is called reentrantiy during the interrupt, the value returned from the first call may be corrupted. 
The problem can occur only in the presence of interrupts. Recursive calls are quite safe. 

1.6 Return, Newline, and Vertical Tab 

The Return character, rather than newline, is represented by \a (a backslash character followed by a 
lowercase n). Return is the usual line termination character on the Macintosh. Return can also be 
represented by \r. Vertical tab is represented by \v. 

1.7 LINE and FILE 



_ _LINE_ _ is a predefined preprocessor symbol whose value is the current line number within the current 
source file. _ _FILE_ _ is a similiar symbol whose value is a character string consisting of the current file 
name. Both symbols begin and end with two underscore characters. 

1.8 Predefined Symbols 

The symbols MC68000, mc68000, m68k, ghs, and macintosh are predefined. Each of the symbols 
has the value 1, as if a statement of this form had appeared at the beginning of the source code: 

#define MC68000 1 

1.9 Standard Apple Numeric Environment Extensions 

The Standard Apple Numeric Environment (SANE) is an extended-precision version of the IEEE Standard 
for Binary Floating-Point Arithmetic (754), together with an exti-a data type and basic functions for 
application development. Workshop C supports this environment Much of SANE is provided through the 
run-time library sanelib and its include file sane,h. However, to use extended-precision arithmetic 
efficientiy and effectively, and to handle IEEE NaNs (Not-a-Number) and infinities, some extensions to 
standard C are required. 
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A change from double to extended as the basic floating-point type is the most salient change to standard C. 
Since C was originally developed on the DEC PDP-1 1, the PDP-1 1 architecture is reflected in standard C in 
the use of float and double as floating-point types, with double as the basic type: floating-point 
expressions are evaluated to double, anonymous variables are double, and floating-point parameters and 
function results are passed as doubles. However, the low-level SANE arithmetic (as well as the floating- 
point chips Intel 8087, Motorola 68881, and Zilog Z8070) evaluates arithmetic operations to the range and 
precision of an 80-bit extended type. Thus, extended naturally replaces PDP-1 1 double as the basic 
arithmetic type for computing purposes. The types float (IEEE single), double, and comp serve as space- 
saving storage types, just as float does in conventional C. 

The IEEE Standard specifies two special representations for its floating-point formats: NaNs (Not-a- 
Number) and infinities. Workshop C expands the syntax for VO to accommodate NaNs and infinities, and 
includes the treatment of NaNs in relationals as required by the IEEE Standard. 

The SANE extensions to standard C are backward compatible: programs written using only float and 
double floating-point types and standard C operations compile and run without modification. SANE does 
not aflect integer arithmetic. 

The Apple Numerics Manual contains detailed documentation of the Standard Apple Numeric 
Environment. 



1.9.1 Constants 

Numeric constants that include floating-point syntax — a point (.) or an exponent field — or that lie outside 
the range of longint are of type extended. Decimal-to-binary conversion for numeric constants is done at 
compile time (and hence is governed by the default numeric environment; compare Section 1.9.6). 

1.9.2 Expressions 

The SANE types — afloat, double, comp, and extended — can be mixed in expressions with each other and 
with integer types in the same manner that float and double can in standard C. An expression consisting 
solely of a SANE-type variable, constant, or function is of type extended. An expression formed by 
subexpressions and an arithmetic operation is of type extended if either of its subexpressions is. Extended- 
type expressions are evaluated using extended-precision SANE arithmetic, with conversions to type extended 
generated automatically as needed. Parentheses in extended-type expressions are honored. Initialization of 
external and static variables, which may include expression evaluation, is done at compile time; all other 
evaluation of extended-type expressions is done at run time. 

1.9.3 Comparisons 

The result of a comparison involving a NaN operand is unordered. The usual trichotomy of numbers is 
expanded to less (<), greater (>), equal (==), and unordered. For example, the negation of "a less than b" is 
not "a greater than or equal to b" but "(a greater than or equal to b) OR (a and b unordered)". 

1.9.4 Functions 

A numeric actual parameter passed by value is an expression and hence is of extended or integer type. All 
extended-type arguments are passed as extendeds. Similarly, all results of functions declared float, double, 
comp, or extended are returned as extendeds. 
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1.9.5 Input/Output 



In addition to the usual syntax accepted for numeric input, the Standard C Library function scanf 
recognizes "INF" as infinity and "NAN" as a NaN. NAN may be followed by parentheses, which may 
contain an integer (a code indicating the NaN's origin). INF and NAN are optionally preceded by a sign and 
are case insensitive. 5cart/ specifiers for SANE types extend standard C as follows: conversion characters 
f, e, and g indicate type float; If, le, and Ig indicate type double; mf, me, and mg indicate type comp; 
and ne, nf, and ng indicate type extended. 

The Standard C Library function prz/i/f writes infinities as [-]INF and NaNs as [-]NAN(ddd), where ddd is 
the NaN code. 



1.9.6 Numeric Environment 

The numeric environment refers to rounding direction, rounding precision, halt enables, and exception flags. 
IEEE Standard defaults— rounding to nearest, rounding to extended precision, and all halts disabled — are in 
effect for compile-time arithmetic (including decimal-to-binary conversion). Each program begins with 
these defaults and with all exception flags clear. Functions for managing the environment are included in 
the library sanelib. The compiler, in optimizing, will not change any part of the numeric environment, 
including the exception-flag setting which is a side effect of arithmetic operations. 

1.9.7 SANE Library 

The SANE library rounds out the IEEE Standard implementation and provides the basic tools for developing 
a wide range of applications. The SANE library includes the following: 

logarithmic, exponential, and trigonometric functions 

financial functions 

random number generation 

binary-decimal conversion 

numeric scanning and formatting 

environment control 

other functions required or recommended by the IEEE Standard 

Additional information can be found under the SANE entry in the Macintosh Interface Libraries section. 

1.9.8 SANE Programming 

Workshop C's automatic use of the extended type produces results that are generally better than those of 
other C systems. Extended precision yields more accuracy and extended range avoids unnecessary underflow 
and overflow of intermediate results. The programmer can further exploit the extended type by declaring all 
floating-point temporary variables to be type extended. This is both time- and space-efficient, since it 
reduces the number of automatic convwsions among types. External data should be stored in one of the 
three smaller SANE types (float, double, or comp), not only for economy but also because the extended 
format may vary among SANE implementations. As a general mle, use float, double, or comp data as 
program input; extended arithmetic for computations; and float, double, or comp data as program output. 

In many instances, IEEE arithmetic allows simpler algorithms than were possible without IEEE arithmetic. 
The handling of infinities enlarges the domain of some formulas. For example, l+l/x^ computes correctiy 
even if x^ overflows. Running witfi halts disabled (the default), a program will never crash due to a 
floating-point exception. Hence by monitoring exception flags a program can test for exceptional cases 
after die fact. The alternative of screening out bad input is often infeasible, sometimes impossible. 
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1.10 Pascal-Compatible Functions 

The function-calling conventions used by Workshop C and Pascal differ radically in the order of parameters 
on the stack, the type coercions applied to parameters, the location of the return result, and the number of 
scratch registers. C has been extended to allow function calls between these languages. The specifier 
pascal in a function declaration or definition indicates a Pascal-compatible function. 

1.10.1 Pascal-Compatible Function Declarations 

A function or procedure written in Pascal (or written in assembly language following Pascal calling 
conventions) can be called from C. A Pascal-compatible extemal function declaration begins with the 
pascal specifier, contains the usual type specifiers, function name, and parameter list, and must also 
contain declarations for the parameters, followed by the word extern. Parameters whose declarations are 
omitted are assumed to be type int. For example, tfie C function declaration 

pascal void DrawText (textBuf , f irstByte,byteCount) 
Ptr textBuf; 

short firstByte,byteCount; 
extern; 

would allow a C program to call the procedure DrawText defined in Pascal as follows: 

PROCEDURE DrawText (textBuf : Ptr; f irstByte,byteCount : INTEGER); 

Pascal-compatible function declarations are used in the Macintosh Interface Libraries to allow C prc^rams 
to directly call Macintosh Ubrary routines that use Pascal calling conventions. The word extern may be 
followed by a constant, which is interpreted as a 16-bit 680(X) instruction that replaces the usual subroutine 
call (JRS) instruction in the calling sequence. This allows direct traps to the Macintosh ROM. For 
example: 

pascal void OpenPort (port) 
Graf Ptr port; 
extern 0xA86F; 

1.10.2 Pascal-Compatible Function Definitions 

A function definition (the actual function), like a function declaration, can also be preceded by the pascal 
specifier. The function then adheres to Pascal-compatible calling conventions and can be called from 
Pascal. For example, the following C function can be called from Pascal: 

pascal void MyText (by teCount, text Addr,numer,denom) 

short byteCount; 

Ptr textAddr; 

Point numer, demon; 
{ 

} 
The corresponding Pascal function declaration would be 

PROCEDURE MyText (bytecount : INTEGER; textAddr: Ptr; numer,denoni: Point); 

For compatibility with Pascal and assembly language, the compiler converts the names of Pascal- 
compatible functions to uppercase before writing them to the object file. When they are called in C 
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programs, these routines should be capitalized exacdy as they were declared in C. Pascal-compatible 
functions whose names differ only in their capitalization will become duplicate declarations when their 
names are converted to uppercase by the compiler; therefore such names should be avoided. 



1.10.3 Parameter and Result Types 

C and Pascal support different data types. Therefore when writing a Pascal-compatible function declaration 
in C, a translation of the parameter types and function-result type (from Pascal to C) is required. Often this 
translation is trivial, but other cases are surprising. 

The table below summarizes this translation. Find the Pascal parameter or result type in the first column. 
Use the equivalent C type found in the second column when declaring the function in C. Comments in the 
table point out unusual cases which may require special attention. 



Pascal Parameter or 
Result Tvpe 

boolean 
var boolean 
boolean result 

enumeration 

(<128 or >255 literals) 
enumeration 

(128 to 255 literals) 
var enumeration 

(<128 or >255 literals) 
var enumeration 

(128 to 255 literals) 
enumeration result 

(<128 or >255 literals) 
enumeration result 

(128 to 255 literals) 



C Efltfivalgnt Comments 



Boolean 
Boolean * 
Boolean 



enum 

short 

enum* 

short* 

enum 

short 



Boolean is defined in file types.h as enum {false,true}. 
In C, false is zero and true is often considered nonzero. 
In Pascal, false is zero and true is one. 



Use identical ordering of the enumeration literals. 

Pascal passes enumerations with 128 or more literals as words. 



char 
var char 
char result 

integer 
var integer 
short result 

longint 
var longint 
longint result 

real 
var real 
real result 

double 
var double 
double result 

comp 



short 

char* 

short 

short 

short* 

short 

int or long 
int * or long * 
int or long 

extended* 

float* 

float 

extended* 
double * 
double 

extended* 



Surprise! Pascal passes chars as 16-bit values. 

16-bit signed values. 

32-bit signed values. 

Pascal passes real parameters as extended by address. 
Pascal returns real results by value. 
Pascal passes double parameters as extended by address. 
The caller supplies the address of the double result. 
Pascal passes comp parameters as extended by address. 
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var comp 


comp* 


comp result 


comp 


extended 


extended* 


var extended 


extended* 


extended result 


extended 


pointer 


pointer 


var pointer 


pointer * 


pointer result 


pointer 


array (lor 2 bytes) 


short 


array (3 or 4 bytes) 


int or long 


array (5 or more bytes) 


array 


var array 


array 


array result 


— 


record (1 to 4 bytes) 


struct 


record (5 or more bytes) 


struct* 


var record (any size) 


struct* 


record result (1 or 2 bytes) 


short 


record result (3 or 4 bytes) 


int or long 


record result (1 or 2 bytes) 


struct 


set(l to 7 elements) 


char 


set (8 to 16 elements) 


short 


set (>17 elements) 


struct 


var set (1 to 7 elements) 


char* 


var set (8 to 16 elements) 


short* 


var set (>17 elements) 


struct* 


set result (1 to 7 elements) 


char 


set result (8 to 16 elements) 


short 


set result ^17 elements) 


struct 



The caller supplies the address of the comp result. 
Pascal passes extended parameters by address. 
The caller supplies the address of the extended result. 
32-bit addresses. 

Pascal passes small arrays by value. 

Pascal passes larger arrays by address. 

C does not allow array results. 

Pascal passes small records by value. 
Pascal passes larger records by address. 

Pascal returns small records by value. 

The caller supplies the address of the record result. 

Pascal passes sets with 1 to 7 elements as bytes. 
Pascal passes sets with 8 to 16 elements as words. 
Pascal also passes larger sets by value. 

Pascal returns small sets by value. 

The caller supplies the address of the set result 



2. 



Implementation-Specinc Language Details 



A number of details in any language definition are left to the discretion of its individual implementations. 
Most programs do not rely on these details and therefore yield the same results on the various 
implementations. However, knowledge of the major differences between implementations can help avoid 
reliance on language semantics that vary from implementation to implementation. This section explains 
several areas of the language definition that are specific to Workshop C. 



2.1 



Byte Ordering 



On the MC68000, the microprocessor used in the Macintosh, the least significant byte of a short or long 
integer has the highest memory address. This byte ordering is also used on IBM/370 and Z8000 processors. 
The PDP-1 1 family, VAX, 8086, and NS 16000 use a different ordering. Programs that rely on the order of 
the bytes within words and longs will not work correctly on both classes of machines. 



2.2 



Memory-Allocation Characteristics 



The Workshop C compiler optimizes memory allocation in various ways. Automatic variables (locals) are 
allocated in registers whenever possible. Static and global variables are not necessarily allocated in the order 
in which they are specified. (However, the order of fields within records is preserved.) Static variables may 
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be allocated as if they were automatic if their values are always set before being referenced. Automatic and 
static variables that are never used may not be allocated at aU. Programs should not rely on the compiler's 
allocation algorithms. 

2.3 Unsigned Char and Unsigned Short 

Types unsigned char and unsigned short are supported by the Workshop C compiler and by many 
implementations of PCC, although they are not required by the basic C language definition. The VAX 
implementation of PCC and the Workshop C compiler differ in the way they evaluate expressions 

involving these types. For example, the negation operator subtracts an unsigned short from 2^^ under 

PCC (this seems like a bug), and from 2^^ under Workshop C. 

2.4 Bit Fields 

Workshop C provides bit fields that are unsigned, as do all MC68000 versions of PCC of which we are 
aware. However, VAX implementations of C may support signed bit fields. In the following example, 
implementations using unsigned bit fields will set i to 3; implementations using signed bit fields will set i 
to-1. 

struct {int field:2;} x; 
X. field = 3; 
i = X. field; 



2.5 Evaluation Order 

Workshop C does not define the evaluation order of certain expressions. Expressions with side effects, such 
as function calls and the "++" and "- -" operators, may yield different results on different machines or with 
different compilers. Specifically, when a variable is modified as a side effect of an expression's evaluation 
and the variable is also used at another point in the same expression, the value used may be either the value 
before modification or the value after modification. 

Programs that rely on the order of evaluation in these situations are in error. The function call f(i,i++) 
is an example of an expression whose value is undefined. 

2.6 Case Statements 

Some implementations of C, including PCC, allow cases of a switch statement to be nested within 
compound statements. Workshop C considers this an error. The following switch statement compiles 
using PCC but generates an error message using the Workshop C compiler. The error is that case 2: is 
within the if statement. 

switch (i) { 
case 1: 

if (j) { 
case 2 : 
i = 3; 
} 
} 
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3. Implementation Notes 



The definition of C specifies the meaning of C programs. Implementations vary considerably in how they 
choose to implement this definition. Certain implementation details are of interest to assembly language 
programmers who want to write functions that either call or are called from C. This section provides those 
details. 



3.1 C Calling Conventions 

Workshop C uses two different function-calling conventions. This section describes the usual C calling 
conventions. The Pascal-compatible calling conventions are described in section 3.2. 

3.1.1 Parameters 

Parameters to C functions are evaluated from right to left and are pushed onto the stack in the order they are 
evaluated. Characters, integers, and enumeration types are passed as sign-extended 32-bit values. Pointers 
and arrays are passed as 32-bit addresses. Types float, double, comp, and extended are passed as extended 80- 
bit values. Structures are also passed on the stack. Their size is rounded up to a multiple of 16 bits (2 
bytes). If rounding occurs, the unused storage has the highest memory address. The caller removes the 
parameters from the stack. 

3.1.2 Function Results 

Characters, integers, enumeration types, and pointers are returned as sign-extended 32-bit values in register 
DO. Types float, double, comp, and extended are returned as extended values in registers DO, Dl, and AO. 
The low-order 16 bits of DO contain the sign and exponent bits; register Dl contains the high-order 32 bits 
of the significand; register AO contains the low-order 32 bits of the significand. Structure values are 
returned as a 32-bit pointer in register DO. The pointer contains the address of a static variable into which 
the result is copied before returning. This implementation of structure function results is not reentrant. 

3.1.3 Register Conventions 

Registers DO, Dl, AO, and Al are scratch registers and are not preserved by C functions. All other registers 
are preserved. Register A5 is the global frame pointer, register A6 is the local frame pointer, and register 
A7 is the stack pointer. Local stack frames are not necessarily created for simple functions. 

3.2 Pascal-Compatible Calling Conventions 

This section describes the conventions used for calling Pascal functions from C and for functions written in 
C that use Pascal-compatible calling conventions. These conventions differ from tiie usual C calling 
conventions defined in section 3.1; they also differ from the calling conventions used by the Pascal 
compiler. 

3.2.1 Parameters 

Parameters to Pascal-compatible functions are evaluated left to right and are pushed onto the stack in the 
order they are evaluated. Characters and enumeration types whose literal values fall in the range of types 
char or unsigned char are pushed as bytes. (This requires a 16-bit word on the stack. The value is in the 
high-order 8 bits; the low-order 8 bits are unused.) Short ints and enumeration types whose literal values 
fall in the range of types short or unsigned short are passed as 16-bit values. Ints, long ints, and the 
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remaining enumeration types are passed as 32-bit values. Pointers and arrays are passed as 32-bit addresses. 
SANE types float, double, comp, and extended are passed as extended 80-bit values; however this doesn't 
correspond to the Pascal compiler's calling conventions, so a compiler warning is given. The table in 
Section 1.10.3 shows the recommended way to pass S/U^ffi-type values to Pascal. Structures are also 
passed by value on the stack, and also yield a compiler warning. Their size is rounded up to a multiple of 
16 bits (2 bytes). If rounding occurs, the unused storage has the highest memory address. The function 
being called removes the parameters from the stack. 

3.2.2 Results 

Function results are returned on the stack. Stack space for the function result is reserved by the caller prior 
to pushing any parameters. Characters and enumeration types whose literal values fall in tilie range of types 
char or unsigned char are returned as bytes. (This requires a 16-bit word on the stack. The value is in the 
high-order 8 bits; the low-order 8 bits are unused.) Short ints and enumeration types whose literal values 
fall in the range of types short or unsigned short are returned as 16-bit values. Ints, long ints, and the 
remaining enumeration types are returned as 32-bit values. Pointers are returned as 32-bit addresses. Arrays 
may not be returned as fimction results. Results of type float are returned as 32-bit values. For structures 
and types double, comp, and extended the caller pushes the address of a structure, double, comp, or extended 
(respectively) in the function-result location on the stack. The procedure being called stores the result at 
this address. The caller removes the function results from the stack. 



3.2.3 Register Conventions 

Registers DO, Dl, D2, AO, and Al are scratch registers. Scratch registers are not preserved by Pascal- 
compatible functions. All other registers are preserved. Register A5 is the global frame pointer, register 
A6 is the local frame pointer, and register A7 is the stack pointer. 



3.3 Compiler Limitations 

On the Macintosh, the total size of all declared global variables, static variables, and string constants cannot 
exceed 32K bytes. Allocate large global arrays on the heap in order to avoid exceeding this limit 

It is impossible to compile very large functions on the Lisa because the compiler's internal data structures 
cannot fit in memory. As functions approach this linut, compilation time increases noticeably. This 
problem can be alleviated by eliminating unnecessary include files, reducing the number of global 
declarations, compiling large functions separately, and rewriting large functions as two or more smaller 
functions. In addition, renaming Workshop files system.debug and system.debug2, then rebooting, will 
give the compiler an additional 80K bytes of memory. 

Static functions are not supported in this implementation of C due to limitations in the Lisa Workshop 
object-file definition. Use of static functions may result in this linker message: 

*** Error - Reference to unknown module type. *** 
Static functions can be eliminated by including the define 

#define static 
at the beginning of each compilation or source file. 
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4. Running the Compiler 

The C compiler is named c.obj. To run tiie compiler, use the Lisa Workshop Run command, as shown in 
the example below. Source file names must end with the suffix ".c.text". The ".text" suffix need not be 
specified in response to the input file prompt. The error-listing file is the console by default. The output 
file (object code file) name is by default the source file name, with the ".text" suffix replaced by ".obj". 

Compiler options may be specified by responding to any of the file name prompts by typing a question 
mark (?) and then pressing Return. The compiler will present a partial list of the available options (a 
complete list appears below). Enter the options you want, including minus sign (-) prefixes, on a single 
line separated by spaces. The compiler will then repeat the file name prompt 

The example below compiles the program mac/c/sample/qdsample.c.text, writing the error listing to the 
console and creating the object file mac/c/sample/qdsample.obj. The -M option is used to direct the code 
to segment sample. Prompts supplied by the Workshop and the compiler are shown in plain text. 
Default file names appear within die prompts in brackets. What you type is printed in boldface. 
"<Retum>" means press the Return key. 

r 

Run what program? c <Return> 

C-68/Lisa 1.8.3 Copyright (c) 1984, 1985 Green Hills Software, Inc. 

Name of input file [.TEXT] ? <Return> 

Useful options include: 

-Mname Compile into segment 'name'. 

-Dname Define 'name' with value 1. 

-Dname=string Define 'name' with value 'string'. 

-Uname Undefine 'name'. 

-Iprefix Add 'prefix' to include-file names. 

-E Write preprocessor output to file 'preproc.text'. 

-g Generate debug symbols in code. 

Enter options separated by blanks and followed by <Retum> 

Options> -Msample <Return> 

Name of input file [.TEXT] mac/c/sample/qdsample.c <Return> 

Name of error listing file [-console] / [.TEXT] <Return> 

Name of binary file [ mac/c/sample/qdsample.c] [.OBJ] <Return> 

4.1 Compiler Options 

The Workshop C compiler recognizes the following options: 

O ption Description 

-Mname Name the object-code segment Since a segment may not exceed 32K bytes, large 

programs require multiple segments with different names. The default segment 
name is 8 blanks. 

-Dname Define name to the preprocessor with the value 1. This is equivalent to writing 

#defme name 1 at the beginning of the source file. 

-Dname=string Define name to the preprocessor with the value "string". This is equivalent to 
writing #define name string at the beginning of the source file. 

-Uname Undefine the predefined preprocessor symbol name. This is equivalent to writing 

#undef name at the beginning of the source file. 
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-Istring 

-w 
-E 
-C 

-g 

-ga 

-X6 

-X9 

-X12 

-Z6 

-X55 



Include file names that do not start with "-" are searched for with the file name prefix 
"string". Multiple -I options can be specified. They will be searched in the oider 
encountered. The include-file search rules are explained in detail in section 4.2. 

Suppress compiler warning messages. By default, warnings are written to the error 
listing file. 

Do not compile the program. Instead, write the output of the preprocessor to file 
preproc.text This option is useful for debugging preprocessor macros. 

Include comments with the preprocessor output. By default, comments are not 
written to the preprocessor output. 

Generate 8-byte function names embedded in the code for the debugger; generate frame 
pointers in A6 (LINK A6^ ... UNLK A6). 

Generate stack frame pointers in A6 (LINK A6^ ... UNLK A6) for all 
functions. 

Use MOVE #0,x instructions rather than CLR x instructions for nonstack 
addresses. This may be useful when writing device drivers. 

Disable local (peephole) optimizations. 

Generate 680 10 code rather than 680(X) code. 

Always allocate 32 bits for enumerated data types. The default is to allocate 8, 16, or 
32 bits. 

Make bit fields of type int, short, and char signed. The default is to make all fields 
unsigned. 



4.2 



Include-File Search Rules 



The compiler automatically searches for include files in the manner described below. The first file 
successfully opened using these rules is included. 



Include-File Name 
Begins with "-" 

In angle brackets. 
In double quotes. 



#include <-lower-consts.h> 
#include "-lower-consts.h" 

#include <ctype.h> 



#include "constants.h" 



Search Rules 

Use the specified name. None of 
the other search rules apply. 

Begin the search using the prefix 
"mac/c/include/". Continue the 
search by prefixing the file name 
with strings supplied as -I options. 

Begin the search using the prefix 
(up to the final "/") of the source 
file that contains the include. 
Continue by prefixing the file name 
with strings supplied as -I options. 
Finally, try the include-file name 
without any prefix. 



Page 15 



Lisa Workshop C User's Guide 

5. Files to Link With 

Workshop C programs should be linked using the linker, linker.obj. Programs to be executed on the Macintosh 
must be linked with one or more of the object files listed below. Programs must be linked with the object files that 
correspond to the libraries the program uses. 

If no Standard C Library functions are called, link with: 

mac/c/lib/runtime.obj Execution starting point. 

If Standard C Library functions are called, link with one of the following: 

mac/c/lib/cruntime.obj Doesn't prompt for argv and argc at the start of execution, 

mac/c/lib/cruntimeargv.obj Prompts for argv and argc. 

If Standard C Library functions are called, also link with: 

mac/c/lib/stdclib.obj Standard C Library, 

mac/c/lib/stdprintf.obj Standard C Library /7rm(/' functions, 

mac/c/lib/math.obj Standard C Library math functions. 

If SANE library functions are called or floating-point arithmetic is used, also link with: 

mac/c/lib/sanelib.obj SANE numerics. 

If Macintosh Interface Libraries functions are called, also link with: 

mac/c/lib/interface.obj Macintosh Interface Libraries. 

If Macintosh Interface Libraries printing functions are called, also link with one of the following: 

obj/prlink.obj High-level printing interfaces, 

obj/prscreen.obj Low-level printing interfaces. 
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6. Standard C Library 



This section describes the Standard C Library provided with Workshop C. After an introductory discussion 
of error-number conventions, the section is arranged alphabetically by function name or category. The 
Library Index is an index of the defines, types, enumeration literals, global variables, and functions defined 
here and in the Macintosh Interface Libraries. 

Remember that identifiers in C are case sensitive and should be spelled exactly as shown in the 
synopsis. Following English usage, we've capitalized the first letter of a lowercase identifier when it 
appears at the beginning of a sentence. 
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NAME 

Introduction to error numbers similar to those in UNIX operating systems. 

SYNOPSIS 

#include <errno.h> 

extern int errno; 

DESCRIPTION 

Many of the Standard C Library functions have one or more error returns. An error 
condition is indicated by an otherwise impossible returned value. This is almost 
always -1; see descriptions of individual functions for details. An error number is 
also made available in the external variable errno. Errno is not cleared on 
successful calls, so it should be tested only after an error has been indicated. 

The error name appears in brackets following the text in a library function 
description; for example, 

"The next attempt to write a nonzero number of bytes will signal an 
error, [enospc]" 

Not all possible error numbers are listed for each library function because many 
errors are possible for most of the calls. Some UNIX operating system error 
numbers do not apply to Macintosh and are not documented in this manual. 

Here is a list of the error numbers and their names as defined in the <ermo.h> file: 

1 [EPERM] Not owner 

Typically this error indicates an attempt to modify a file in a 
way that is not permitted. 

2 [ENOENT] No such file or directory 

This error occurs when a file whose filename is specified 
does not exist or when one of the directories in a pathname 
does not exist. 

5 [EIO] I/O error 

Some physical I/O error has occurred. This error may in 
some cases be signaled on a call following the one to which 
it actually applies. 

6 [ENXIO] No such device or address 

I/O on a special file refers to a subdevice that does not exist, 
or the I/O is beyond the limits of the device. This error may 
also occur when, for example, no disk is present in a drive. 

9 [EBADF] Bad file number 

Eitiier a file descriptor does not refer to an open file, or a 
read (or write) request is made to a file that is open only for 
writing (or reading). 
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12 [ENOMEM] Not enough space 

The system ran out of memory while the library call was 
executing. 

13 [EACCES] Permission denied 

An attempt was made to access a file in a way forbidden by 
the protection system. 

17 [EEXIST] File exists 

An existing file was mentioned in an inappropriate context — 

e.g., open (file, 0_CREAT+0_EXCL) . 

19 [ENODEV] No such device 

An attempt was made to apply an inappropriate system call to 
a device — e.g., read a write-only device. 

2 [ENOTDIR] Not a directory 

An object that is not a directory was specified where a 
directory is required — e.g., in a path prefix. 

21 [EISDIR] Is a directory 

An attempt was made to write on a directory. 

22 [EINVAL]] Invalid argument 

Some invalid argument was provided to a library function. 

23 [ENFILE] File table overflow 

The system's table of open files is full, so temporarily a call 
to open() cannot be accepted. 

2 4 [EMFILE] Too many open files 

No program may have more than 20 file descriptors open at 
a time. 

2 8 [ENDS PC] No space left on device 

During a write() to an ordinary file, there is no free space left 
on the device. 

2 9 [ESPIPE] Illegal seek 

An IseekO was issued incorrectly. 

30 [erOFS] Read-only file system 

An attempt to modify a file or directory was made on a 
device mounted for read-only access. 

NOTE 

Calls that interface to the Macintosh I/O system — e.g., open(), close(), read(), 
writeO, ioctlO, and others — set the external variable MacOSErr as well as errno. 
This manual documents only errno values. The equivalent Macintosh ROM error- 
return values set in MacOSErr are documented in Inside Macintosh. The 
appropriate include file for most values of MacOSErr is <files.h>. 
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NAME 

abs — ^return integer absolute value 

SYNOPSIS 

int abs (i) 
int i ; 

DESCRIPTION 

Abs returns the absolute value of its integer operand. 

NOTE 

The absolute value of the negative integer with largest magnitude is undefined. 

SEE ALSO 

floorO. 
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NAME 

atof — convert ASCII string to floating-point number 

SYNOPSIS 

extended atof (nptr) 
char *nptr; 

DESCRIPTION 

Ato/ converts a character string pointed to by nptr to an extended-precision 
floating-point number. The first unrecognized character ends the conversion. Atof 
recognizes an optional string of white-space characters (blanks or tabs), then an 
optional sign, then a string of digits optionally containing a decimal point, then an 
optional "e" or "E" followed by an optionally signed integer. If the string begins 
with an unrecognized character, ar<?/ returns a NaN. 

DIAGNOSTICS 

A to/ honors the floating-point exception flags — invalid operation, underflow, 
overflow, divide by zero, and inexact — as prescribed by the Standard Apple 
Numeric Environment (SANE). 

SEE ALSO 

scanfO, str2dec(), dec2num() . 
Apple Numerics Manual. 
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NAME 

atoi — convert string to integer 

SYNOPSIS 

int atoi (str) 
char *str; 

DESCRIPTION 

Atoi returns as an integer the decimal value represented by the character string str. 
The string is scanned up to the first nondigit character other than an optional leading 
minus sign (-). Leading white-space characters (blanks and tabs) are ignored. 

NOTE 

Overflow conditions are ignored. 

SEE ALSO 

atof r scanf () . 
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NAME 

close — close a file descriptor 

SYNOPSIS 

int close (fildes) 
int fildes; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat() or open() call. Close closes the 
file descriptor indicated by fildes. 

Close fails if fildes is not a valid open file descriptor, [ebadf] 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of-1 is 
returned and errno is set to indicate the error. 

SEE ALSO 

creat () , openO . 
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NAME 

toupper, tolower, _toupper, _tolower, toascii 
— ^translate characters 

SYNOPSIS 

iinclude <ctype.h> 

int toupper (c) 
int c; 

int tolower (c) 
int c ; 

int _toupper (c) 
int c ; 

int _tolower (c) 
int c ; 

int toascii (c) 
int c; 

DESCRIPTION 

Toupper and tolower have as domain the range of getc(): the integers from -1 
through 255. If the argument of toupper represents a lowercase letter, the result is 
the corresponding uppercase letter. If the argument of tolower represents an 
uppercase letter, 3ie result is the corresponding lowercase letter. AH other 
arguments in the domain are returned unchanged. 

Toupper and jolower are macros that accomplish the same thing as toupper 
and tolower but have restricted domains and are faster. Toupper requires a 
lowercase letter as its argument; its result is the corresponding uppercase letter. 

Tolower requires an uppercase letter as its argument; its result is the 
corresponding lowercase letter. Arguments outside the domain cause undefined 
results. 

Toascii yields its argument with all bits turned off that are not part of a standard 
ASCn character; it is intended for compatibility with other systems. 

SEE ALSO 

ctype, getc () . 
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NAME 

creat — create a new file or rewrite an existing file 

SYNOPSIS 

int creat (path) 
char *path; 

DESCRIPTION 

Creat creates a new file or prepares to rewrite an existing file named by the 
pathname pointed to by path. If the file exists, the lengtih of its data fork is 
truncated to 0. 

Creat is equivalent to open (path , o_wronly | o_trunc ) . 

Upon successful completion, a nonnegative integer (the file descriptor) is returned 
and the file is open for writing. The file pointer is set to the beginning of the file. 
A maximum of 20 files may be open at a given time. 

RETURN VALUE 

Upon successful completion, a nonnegative integer (the file descriptor) is returned. 
Otherwise, a value of -1 is returned and errno is set to indicate the error. 

SEE ALSO 

close 0, IseekO, open(), readO, write (). 
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NAME 

isalpha, isupper, islower, isdigit, isxdigit, isalnum, isspace, ispunct, isprint, 
isgraph, iscntrl, isascii 

— classify characters 

SYNOPSIS 

#include <ctype.h> 

int isalpha (c) 
int c; 



DESCRIPTION 

These macros classify character-coded integer values by table lookup. Each is a 
predicate returning nonzero for true, zero for false. Isascii is defined on all integer 
values; the rest are defined only where isascii is true and on the single non- ASCII 
value EOF (-1). 

isalpha c is a letter. 

isupper c is an uppercase letter. 

islower c is a lowercase letter. 

isdigit c is a digit [0-9]. 

isxdigit c is a hexadecimal digit [0-9], [A-F], or [a-fj. 

isalnum c is alphanumeric (letter or digit). 

isspace c is a space, tab, return, new line, vertical tab, or form feed. 

ispunct c is a punctuation character (neither control nor alphanumeric). 

isprint c is a printing character, code 040 (space) through 0176 (tilde). 

isgraph c is a printing character, similar to isprint except false for space. 

iscntrl c is a delete character (0177) or an ordinary control character (less 

than 040). 

isascii c is an ASCII character, code less than 0200. 

DIAGNOSTICS 

If the argument to any of these macros is not in the domain of the function, the 
result is undefined. 
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NAME 

ecvt, fcvt — convert floating-point number to string 

SYNOPSIS 

char *ecvt (value, ndigit, decpt, sign) 

extended value; 

int ndigit, *decpt, *sign; 

char *fcvt (value, ndigit, decpt, sign) 

extended value; 

int ndigit, * decpt, *sign; 

DESCRIPTION 

Ecvt converts value to a null-terminated string of ndigit digits and returns a 
pointer to this string as the function result The low-order digit is rounded. 

The decimal point is not included in the returned string. The position of the decimal 
point is indicated by decpt, which indirectly stores the position of the decimal point 
relative to the returned string. If the int pointed to by decpt is negative, the decimal 
point lies to the left of the returned string. For example, if the string is " 12345" and 
decpt points to an int of 3, the value of the string is 123.45; if decpt points to -3, 
the value of the string is .00012345 . 

If the sign of the converted value is negative, the word pointed to by sign is 
nonzero; otherwise it is zero. 

Fcvt and ecvt provide fixed-point output in the style of Fortran F-format output, 
with the following difference in the interpretation of ndigit. 

In fcvt, ndigit specifies the number of digits to the right of the decimal point. 
In ecvt, ndigit specifies the number of digits in the string. 



NOTE 



The string pointed to by the function result is static data whose content is 
overwritten by each call. 



SEE ALSO 

printfO, num2dec(), dec2str. 
Apple Numerics Manual. 
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NAME 

exit, exit — ^temiinate the current application 

SYNOPSIS 

void exit (status) 
int status; 
void _exit (status) 
int status; 

DESCRIPTION 

Exit terminates the current application, closing all of the open file descriptors. It 
also causes stdio() cleanup actions before the application terminates. 

The function _exit circumvents all cleanup. 
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NAME 

exp, log, log 10, pow, sqrt 

— exponential, logarithm, power, square-root functions 

SYNOPSIS 

#include <inath.h> 

extended exp (x) 
extended x; 

extended log(x) 
extended x; 

extended loglO (x) 
extended x; 

extended pow(x, y) 
extended x, y; 

extended sqrt (x) 
extended x; 

DESCRIPTION 

Exp returns e^, where e is the natural logarithm base. 

Log returns the natural logarithm (base e) of x. 

LoglO returns the logarithm base ten of x. 

Pow returns xY. 

Sqrt returns the square root of x. 

For special cases, these functions return a NaN or signed infinity as appropriate. 

DIAGNOSTICS 

These functions honor the floating-point exception flags — invalid operation, 
underflow, overflow, divide by zero, and inexact — as prescribed by the Standard 
Apple Numeric Environment (SANE). 

SEE ALSO 

hypot , sinh () . 

Apple Numerics Manual. 
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NAME 

fclose, fflush — close or flush a stream. 

SYNOPSIS 

#include <stdio.h> 

int fclose (stream) 
FILE ^stream; 

int fflush (stream) 
FILE *stream; 

DESCRIPTION 

Fclose causes any buffered data for stream to be written out; stream is then 
closed. 

Fclose is performed automatically for all open files upon calling exit(). 

Fflush causes any buffered data for stream to be written out; stream remains 
open. 

DIAGNOSTICS 

These functions return for success or EOF if an error was detected (such as trying 
to write to a file that has not been opened for writing). 

SEE ALSO 

close Of exitO, fopenO, setbufO. 
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NAME 

ferror, feof, clearerr, fileno — ^stream status inquiries 

SYNOPSIS 

finclude <stdio.h> 

int feof (stream) 
FILE *stream; 

int ferror (stream) 
FILE *stream; 

void clearerr (stream) 
FILE *stream; 

int fileno (stream) 
FILE *stream/ 

DESCRIPTION 

Feo/retums nonzero when end-of-file has previously been detected reading the 
named input stream; otherwise, it returns zero. 

Ferror returns nonzero when an I/O error has previously occurred reading from or 
writing to the named stream; otherwise, it returns zero. 

Clearerr resets the error indicator and end-of-file indicator to zero on the named 
stream. 

Fileno returns the integer file descriptor associated with the named stream; see 
openQ. 

NOTE 

All these functions are implemented as macros; they cannot be declared or 
redeclared. 

SEE ALSO 

open ( ) , f open ( ) . 
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NAME 

floor, ceil, fmod, fabs — floor, ceiling, mod, absolute value functions 

SYNOPSIS 

#include <math.h> 

extended floor (x) 
extended x; 

extended ceil(x) 
extended x; 

extended finod(x, y) 
extended x, y; 

extended f abs (x) 
extended x; 

DESCRIPTION 

Floor returns the largest integer (as an extended-precision number) not greater than 

X. 

Ceil returns the smallest integer not less than x. 

Whenever possible, /mo<i returns the number f with the same sign as x, such that 
X = iy + f for some integer i, and |fl < |y|. If y is zQtOyfmod retums a NaN. 

Fabs retums |x|. 

SEE ALSO 

absO, rintO, setroundO . 
Apple Numerics Manual. 
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NAME 

fopen, freopen, fdopen — open a stream 

SYNOPSIS 

tinclude <stdio.h> 

FILE *£open (filename^ type) 
char ^filename, *type; 

FILE *freopen (filename, type, stream) 
char *filename, *type; 
FILE *stream; 

FILE *fdopen (fildes, type) 
int fildes; 
char *type; 

DESCRIPTION 

Fopen opens the file named by filename and associates a stream with it. Fopen 
returns a pointer to the FILE structure associated with the stream. 

Filename points to a character string that contains the name of the file to be 
opened. 

Type is a character string having one of the following values: 

r open for reading. 

w truncate or create for writing. 

a append: open for writing at end-of-file, or create for writing. 

r+ open for update (reading and writing). 

w+ truncate or create for update. 

a+ append: open or create for update at end-of-file. 

Freopen substitutes the named file for the open stream. The original stream is 
closed, regardless of whether the open ultimately succeeds. Freopen returns a 
pointer to the FILE structure associated with stream. 

Freopen is typically used to attach the previously opened streams associated with 
stdin, stdout, and stderr to other files. 

Fdopen associates a stream with a file descriptor by formatting a file structure 
from the file descriptor. T\i\x^, fdopen can be used to access tilie file descriptors 
returned by open() or creatQ. (These calls open files but do not return pointers to a 
FILE structure.) The type of stream must agree with the mode of the open file. 

When a file is opened for update, both input and output may be done on the 
resulting stream. However, output may not be directly followed by input without 
an intervening fseek() or rewind(), and input may not be directly followed by 

Page 33 



FOPEN Standard C Library FOPEN 

output without an intervening fseekQ, rewindO, or an input operation that 
encounters end-of-file. 

When a file is opened for append (i.e„ when type is "a" or '*a+"), it is impossible 
to overwrite information already in the file. Fseek() may be used to reposition the 
file pointer to any position in the file, but when output is written to the file the 
current file pointer is disregarded. AH output is vmtten at the end of the file and 
causes the file pointer to be repositioned at the end of the output. 

DIAGNOSTICS 

Fopen andfreopen return a null pointer on failure. 

SEE ALSO 

openO , fcloseO . 
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NAME 

fread, fwrite — ^binary input/output 

SYNOPSIS 

#include <stdio.h> 

int fread (ptr, size, nitems, stream) 

char *ptr; 

int size, nit ems; 

FILE * St ream; 

int fwrite (ptr, size, nitems, stream) 

char *ptr; 

int size, nitems; 

FILE ^stream; 

DESCRIPTION 

Fread copies nitems items of data from the named input stream into an array 
beginning dXptr. An item of data is a sequence of bytes (not necessarily terminated 
by a null byte) of length size. Fread stops appending bytes if an end-of-file or 
error condition is encountered while reading stream or if nitems items have been 
read. Fread leaves the file pointer in stream^ if defined, pointing to the byte 
following the last byte read if there is one. Fread does not change the contents of 
stream, 

Fwrite appends at most nitems items of data to the named output stream from the 
array pointed to by ptr. Fwrite stops appending when it has appended nitems 
items of data or if an error condition is encountered on stream. Fwrite does not 
change the contents of the array pointed to by ptr. 

The variable size is typically sizeof (*ptr) where the pseudo-function sizeof 
specifies the length of an item pointed to by ptr. If ptr points to a data type other 
than char it should be cast into a pointer to char. 

DIAGNOSTICS 

Fread and fwrite return the number of items read or written. If nitems is zero or 
negative, no characters are read or written and zero is returned by both fread and 
fwrite. 

SEE ALSO 

fopenO, getcO, getsO, printfO, putc(), putsO, readO, 
scanfO, stdioO, write (). 
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NAME 

frexp, Idexp, modf — manipulate parts of floating-point numbers 

SYNOPSIS 

extended frexp (value, eptr) 
extended value; 
int *eptr; 

extended Idexp (value, exp) 
extended value; 
int exp; 

extended modf (value, iptr) 
extended value, *iptr; 

DESCRIPTION 

Every nonzero number can be written uniquely as x* 2^, where the mantissa 
(fraction) x is in the range 0.5 < |x| < 1.0, and the exponent n is an integer. Frexp 
returns the mantissa of an extended value and stores the exponent indirectly in the 
location pointed to by eptr. Note that the mantissa here differs from the significand 
described in the Apple Numerics Manual, whose normal values are in tilie range 
1.0 < |x| < 2.0 . 

Ldexp returns the quantity va/Mc* 2^^P. 

Modf xQixxms the signed fractional part of value and stores the integral part 
indirectly in the location pointed to by iptr. 

DIAGNOSTICS 

Ldexp honors the floating-point exception flags — ^invalid operation, underflow, 
overflow, divide by zero, and inexact — as prescribed by the Standard Apple 
Numeric Environment (SANE). 

SEE ALSO 

logbO , scalbO . 

Apple Numerics Manual. 
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NAME 

fseek, rewind, ftell — ^reposition a file pointer in a stream 

SYNOPSIS 

#inciude <stdio.h> 

int fseek (stream, offset, ptrname) 
FILE *stream; 
long offset; 
int ptrname; 

void rewind (stream) 
FILE *stream; 

long ftell (stream) 
FILE *stream; 

DESCRIPTION 

Fseek sets the position of the next input or output operation on the stream. The 
new position is at the signed distance ojfset bytes from the beginning, the current 
position, or the end of the file, when the value of ptrname is 0, 1, or 2, 
respectively. 

Rewind (stream) is equivalent to fseek (stream, OL, 0) except that no value is 
returned. 

Fseek and rewind undo any effects of ungetc(). 

Aft&r fseek or rewind, the next operation on a file opened for update may be 
either input or output. 

Fre// returns the offset of the current byte relative to the beginning of the file 
associated with the named stream. 

DIAGNOSTICS 

Fseek returns nonzero for improper seeks; otherwise it returns 0. An improper 
seek can be, for example, an fseek done on a file that has not been opened via 
fopen(). 

SEE ALSO 

IseekO , fopen() . 
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NAME 

getc, getchar, fgetc, getw — get character or word from stream 

SYNOPSIS 

#include <stdio.h> 

int getc (stream) 
FILE *stream; 

int getchar 

int fgetc (stream) 
FILE *stream; 

int getw (stream) 
FILE *stream; 

DESCRIPTION 

Getc returns the next character (i.e., byte) from the named input stream. It also 
moves the file pointer, if defined, ahead one character in stream. Getc is a macro 
and therefore cannot be used if a function is necessary; for example, you cannot 
have a function pointer point to it. 

Getchar returns the next character from the standard input stream, stdin. Like 
getc, getchar is a macro. 

Fgetc behaves lik&getc but is a function. Fgetc runs more slowly than getc but 
taies less space per invocation. 

Getw returns the next "word" (i.e., four bytes) from the named input stream so 
that the order of bytes in the stream corresponds to the order of byes in memory. 
Getw returns the constant EOF upon end-of-file or error. Since EOF is a valid 
integer value, feof() and ferrorQ should be used to check the success of getw. 
Getw increments the associated file pointer, if defined, to point to the next word. 
Getw assumes no special alignment in the file. 

DIAGNOSTICS 

These functions return the integer constant EOF at end-of-file or upon an error. 

NOTE 

Because it is implemented as a macro, getc treats incorrectly a stream argument 
with side effects. In particular, getc ( *f ++) doesn't work as you would expect. 
Use fgetc (*f++) instead. 

SEE ALSO 

fcloseO, ferrorO, fopenO, freadO, getsO, putcO, scanfO, 
stdio . 
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NAME 

gets, fgets — ^get a string from a stream 

SYNOPSIS 

#include <stdio.h> 

char *gets(s) 
char *s; 

char *fgets(s, n, stream) 

char *s; 

int n; 

FILE *stream; 

DESCRIPTION 

Gets reads characters from the standard input stream, stdifiy into the array pointed 
to by Sy until a newline character is read or an end-of-file condition is encountered. 
The newline character is discarded and the string is terminated with a null character. 

Fgets reads characters from the stream into the array pointed to by s until n-1 
characters are read, or a newline character is read and transferred to 5, or an end-of- 
file condition is encountered. The string is then terminated with a null character. 

DIAGNOSTICS 

If end-of-file is encountered and no characters have been read, no characters are 
transferred to s and a null pointer is returned. If a read error occurs, a null pointer 
is returned. Otherwise s is returned. (A read error will occur, for example, if you 
attempt to use these functions on a file that has not been opened for reading.) 

SEE ALSO 

ferrorO, fopenO, freadO, getc () , scanf(), stdioO. 
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NAME 

hypot — Euclidean distance function 

SYNOPSIS 

#include <math.h> 

extended hypot (x, y) 
extended x, y; 

DESCRIPTION 

Hypot returns 

sqrt (x * X + y * y) 

taking precautions against unwarranted overflows. 

DIAGNOSTICS 

Hypot honors the floating-point exception flags — invalid operation, underflow, 
overflow, divide by zero, and inexact — as prescribed by the Standard Apple 
Numeric Environment (SANE). 

SEE ALSO 

sqrt ( ) . 

Apple Numerics Manual. 
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NAME 

Iseek — ^move read/write file pointer 

SYNOPSIS 

long Iseek (fildes, offset, whence) 
int fildes; 
long offset; 
int whence ; 

DESCRIPTION 

Fildes is a file descriptor returned from a creat() or open() call. Lseek sets the file 
pointer associated v/iih fildes as follows: 

If whence is 0, the pointer is set to offset hytQS. 

If whence is 1, the pointer is set to its current location plus offset. 

If whence is 2, the pointer is set to the size of the file plus offset. 

Upon successful completion, the resulting pointer location as measured in bytes 
from the beginning of the file is retumed. 

Lseek fails and the file pointer remains unchanged if one or more of the following 
are true: 

Fildes is not an open file descriptor, [ebadf] 

Whence is not 0, 1, or 2. [einval] 

The resulting file pointer would be negative, [einval] 

Some devices are incapable of seeking. The value of the file pointer associated with 
such a device is undefined. 

RETURN VALUE 

Upon successful completion, a nonnegative integer indicating the file pointer value 
is retumed. Otherwise, a value of -1 is retumed and errno is set to indicate the 
error. 

NOTE 

In previous versions of the Standard C Library, tell (f iiedes) was a function that 
retumed the current file position. It is equivalent to the call lseek ( fildes , ol, i ) . 

SEE ALSO 

creat () , open () . 
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NAME 

malloc, free, realloc, calloc— main memory allocator 

SYNOPSIS 

char *malloc (size) 
unsigned size; 

void free (ptr) 
char *ptr; 

char *realloc(ptr, size) 
char *ptr; 
unsigned size; 

char *calloc (nelem, elsize) 
unsigned nelem, elsize; 

DESCRIPTION 

Malloc and free provide a simple general-purpose memory allocation package. 
The memory that is allocated for a program's use is known as the "storage arena." 
The storage arena expands as malloc is called. 

Malloc returns a pointer to a block of at least size bytes suitably aligned for any 
use. The argument to free is a pointer to a block previously allocated by malloc; 
after free is performed this space is made available for further allocation. 

Undefined results occur if the space assigned by malloc is overrun or if some 
random value is handed to free, 

Malloc allocates the first sufficiently large contiguous reach of free space it finds. 
It calls NewPointerO to get more memory fi-om tiie system when there is no suitable 
space already free. 

Realloc changes the size of the block pointed to by ptr to size bytes and returns a 
pointer to the (possibly moved) block. The contents are unchanged up to the lesser 
of the new and old sizes. If no free block of size bytes is available in the storage 
arena, realloc asks malloc to enlarge the storage arena by size bytes and then 
moves the data to the new space. 

Calloc allocates space for an array of nelem elements of size elsize. The space is 
initialized to zeros. 

DIAGNOSTICS 

Malloc, realloc, and calloc return a null pointer if there is no available memory 
or if the storage arena has been detectably corrupted by storing outside the bounds 
of a block. When this happens the block pointed to by ptr may have been 
destroyed. 
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NAME 

memccpy, memchr, memcmp, memcpy, memset — memory operations 

SYNOPSIS 

char *memccpy (si, s2, c, n) 
char *sl, *s2; 
int c, n; 

char *niemchr(s, c, n) 
char *s; 
int c, n; 

int memcmp (si, s2, n) 
char *sl, *s2; 
int n; 

char *memcpy(sl, s2, n) 
char *sl, *s2; 
int n; 

char *memset(s, c, n) 
char *s; 
int c, n; 

DESCRIPTION 

These functions operate efficiently on memory areas (arrays of characters bounded 
by a count, not terminated by a null character). They do not check for the overflow 
of any receiving memory area. 

Memccpy copies characters from memory area s2 into si, stopping after the first 
occurrence of character c has been copied or after n characters have been copied, 
whichever comes first. It returns either a pointer to the character after the copy of c 
in si or a null pointer if c was not found in the first n characters of s2. 

Memchr returns either a pointer to the first occurrence of character c in the first n 
characters of memory area .s or a null pointer if c does not occur. 

Memcmp compares its arguments, looking at the first n characters only. It returns 
an integer less than, equal to, or greater than 0, depending on whether si is less 
than, equal to, or greater than s2 in the ASCII collating sequence. 

Memcpy copies n characters from memory area s2 to si. It returns si. 

Memset sets the first n characters in memory area s to the value of character c. It 
returns s. 



NOTE 



Overlapping moves may yield unexpected results. 
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NAME 

open — open for reading or writing 

SYNOPSIS 

#include <fcntl.h> 

int open (path, of lag) 
char *path; 
int oflag; 

DESCRIPTION 

Path points to a pathname naming a file. Open opens a file descriptor for the 
named file and sets the file status flags according to the value of oflag. Oflag 
values are constructed by or-ing flags from the following list (only one of the first 
three flags below may be used): 

0_RDONLY Open for reading only. 

OWRONLY Open for writing only. 

0_RDWR Open for reading and writing. 

0_APPEND If set, the file pointer is set to the end of the file prior to 

each write. 

0_CREAT If the file does not exist, it is created. 

0_TRUNC If the file exists, its length is truncated to 0; the mode and 

owner are unchanged. 

0_EXCL If 0_EXCL and 0_CRE AT are set, open fails if tiie file 

exists. 

Upon successful completion a nonnegative integer, the file descriptor, is returned. 
No application may have more than 20 file descriptors open simultaneously. The 
file pointer used to mark the current position within the file is set to the beginning of 
tiiefile. 

The named file is opened unless one or more of the following are true: 

0_CREAT is not set and the named file does not exist, [enoent] 

20 file descriptors are currently open, [emfile] 

0_CREAT and 0_EXCL are set and the named file exists, [eexist] 

RETURN VALUE 

Upon successful completion, a nonnegative integer (the file descriptor) is returned; 
otherwise, a value of -1 is returned and errno is set to indicate the error. 

SEE ALSO 

close 0, creatO, IseekO, readO, write (). 
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NAME 

printf , fprintf, sprintf — sprint formatted output 

SYNOPSIS 

tinclude <stdio.h> 

int printf (format [ , arg ] ... ) 
char *forinat; 

int fprintf (stream, format [ , arg ] ... ) 
FILE * stream; 
char ^format; 

int sprintf (str, format [ , arg ] ... ) 
char *str, format; 

DESCRIPTION 

Prm^ places formatted output on the standard output stream stdout. Fprintf 
places formatted output on the named output stream. 5pr/n«f places formatted 
output, followed by the null character (\0), into the character array pointed to by 
str; it's your responsibility to ensure that enough storage is available. Each 
function returns the number of characters transmitted (not including the \0 in the 
case of sprintf), or a negative value if an output error was encountered. 

Each of these functions converts, formats, and prints its args under control of the 
format. The format is a character string that contains two types of objects: plain 
characters, which are simply copied to the output stream, and conversion 
specifications, each of which results in fetching zero or more args. The results are 
undefined if there are insufficient args for the format. If the format is exhausted 
while args remain, the extra args are ignored. 

Each conversion specification is introduced by the character %. After %, the 
following appear in sequence: 

• Zero or more flag characters, which modify the meaning of the conversion 
specification. 

• An optional decimal digit string specifying a minimum field width. If the 
converted value has fewer characters than the field width, it will be padded 
to the field width on the left (default) or right (if the left-adjustment flag has 
been given); see below for flag specification. 

• A precision that gives the minimum number of digits to appear for the d, o, 
u, X, or X conversions, the number of digits to appear after the decimal 
point for the e, E, and f conversions, the maximum number of significant 
digits for the g and G conversions, or the maximum number of characters 
to be printed from a string in s conversion. The format of the precision is a 
period (.) followed by a decimal digit string; a null digit string is treated as 
zero. 

• An optional 1 specifying that a following d, o, u, x, or X conversion 
character applies to a long-integer arg. The 1 option is ignored in this 
implementation since integers and long integers both require 32 bits. 
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• A character that indicates the type of conversion to be applied. 

A field width or precision may be indicated by an asterisk (*) instead of a digit 
string. In this case, an integer arg supplies the field width or precision. The arg 
that is actually converted is not fetched until the conversion letter is seen; therefore, 
the args specifying field width or precision must appear immediately before the arg 
(if any) to be converted. 

The flag characters and their meanings are: 

- The result of the conversion will be left-justified within the field. 

+ The result of a signed conversion always begins with a sign 

(+or-). 

blank If the first character of a signed conversion is not a sign, a blank will 

be prefixed to the result. Tliis implies that if the blank and + flags 
bofii appear, the blank flag will be ignored. 

# This flag specifies that the value is to be converted to an "alternate 

form." For c, d, s, and u conversions, the flag has no effect. For 
o conversion, it increases the precision to force the first digit of the 
result to be a zero. For x (X) conversion, a nonzero result will have 
"Ox" ("OX") prefixed to it. For e, E, f, g, and G conversions, the 
result will always contain a decimal point, even if no digits follow 
the point. (Normally, a decimal point appears in the result of these 
conversions only if a digit follows it.) For g and G conversions, 
trailing zeros in the fractional part will not be removed from the 
result (as they normally are). 

The conversion characters and their meanings are: 

d ,0 ,u ,x ,X The integer arg is converted to signed decimal (d), unsigned octal 
(o), decimal (u), or hexadecimal notation (x and X), respectively; 
the letters "abcdef are used for x conversion and the letters 
"ABCDEF' for X conversion. The precision specifies the minimum 
number of digits to appear; if the value being converted can be 
represented in fewer digits, it will be expanded with leading zeros. 
The default precision is 1. The result of converting a zero value 
with a precision of zero is a null string. 

f Tlie float, double, comp, or extended arg is converted to decimal 

notation in the style "[-]ddd.ddd", where the number of digits after 
the decimal point is equal to the precision specification. If the 
precision is missing, it is assumed to be 6; if the precision is 
explicitly 0, no decimal point appears. Infinities are printed as 
"HINF" and NaNs are printed as "[-]NAN(ddd)" where ddd is a 
code indicating why the result is not a number. 

e,E The float, double, comp, or extended arg is converted in the style 

"[-]d.ddde±dd", where tihere is one digit before the decimal point 
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and the number of digits after it is equal to the precision; when the 
precision is missing, it is assumed to be 6; if the precision is zero, 
no decimal point appears. The E format code produces a number 
with "E" instead of "e" introducing the exponent. The exponent 
always contains at least two digits. Infinities are printed as "ESTF" 
and NaNs are printed as "[-]NAN(ddd)", where ddd is a code 
indicating why the result is not a number. 

g,G The float, double, comp, or extended arg is printed in style f or e 

(or in style E in the case of a G format code), with the precision 
specifying the number of significant digits. The style used depends 
on the value converted: style e is used only if the exponent resulting 
from the conversion is less than -4 or greater than the precision. 
Trailing zeros are removed from the result. A decimal point appears 
only if it is followed by a digit. 

c The character arg is printed. 

s The arg is taken to be a string (character pointer) and characters from 

the string are printed until a NULL character (\0) is encountered or 
the number of characters indicated by the precision specification is 
reached. If the precision is missing, it is taken to be infinite, so all 
characters up to the first null character are printed. If the string 
pointer arg has the value zero, the result is undefined. A null arg 
yields undefined results. 

% Print a %; no argument is converted. In no case does a nonexistent 

or small field width cause truncation of a field; if the result of a 
conversion is wider than the field width, the field is simply 
expanded to contain the conversion result. Characters generated by 
printf 2nd fprintf aiQ printed as if putc() had been called. 

EXAMPLES 

To print a date and time in the form "Sunday, July 3, 10:02", where weekday and 
month are pointers to nuU-terminated strings: 

printf("%s, %s %d, %.2d:%.2d", weekday, month, day, hour, min) ; 

To print pi to 5 decimal places: 

print f ("pi = %.5f", pi()); 

SEE ALSO 

dec2str, ecvt () , num2dec(), putcO, scanf(), stdio(). 
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NAME 

putc, putchar, fputc, putw — ^put character or word on a stream 

SYNOPSIS 

tinclude <stdio.h> 

int putc (c, stream) 

char c; 

FILE *stream; 

int putchar (c) 
char c; 

int fputc <c, stream) 

char c; 

FILE *stream; 

int putw(w, stream) 

int w; 

FILE *stream; 

DESCRIPTION 

Putc writes the character c to the output stream at the position pointed to by the file 
pointer, if one is defined. Putchar (c) is equivalent to putc(c, stdout). Putc 
and putchar are macros. 

Fputc behaves like putc but is a function rather than a macro. Fputc runs more 
slowly than putc but takes less space per invocation. 

Putw writes the "word" w (i.e., four bytes) to the output stream at the position 
pointed to by the file pointer, if one is defined. Putw neither assumes nor causes 
special alignment in the file. 

Output streams, with the exception of the standard error stream stderr, are by 
default buffered if the output refers to a file and line-buffered if the output refers to 
a window. Stderr is by default unbuffered, but use of freopen() causes it to 
become buffered or line-buffered. When an output stream is unbuffered 
information, it is queued for writing on the destination file or window as soon as 
written; when it is buffered, many characters are saved up and written as a block; 
when it is line-buffered, each line of output is queued for writing on the destination 
window as soon as the line is completed (i.e., as soon as a newline character is 
written or terminal input is requested). Setbuf() may be used to change the stream's 
buffering strategy. 

DIAGNOSTICS 

On success, these functions each return the value they have written. On failure, 
they return the constant EOF. This occurs if the file stream is not open for writing 
or if the output file cannot be grown. Because EOF is a valid integer, ferror() 
should be used to detect putw errors. 

NOTE 

Because it is implemented as a macro, putc treats incorrectly a stream argument 
witii side effects. In particular, putc (c, *f ++) ; doesn't work as you would 
expect. Fputc should be used instead. 
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SEE ALSO 

fcloseO, ferrorO, fopen(), freadO, getc(), printfO, putsO 
setbufO, stdioO. 
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NAME 

puts, fputs — write a string to a stream 

SYNOPSIS 

#include <stdio.h> 

int puts(s) 
char *s; 

int fputs (s, stream) 
char *s; 
FILE *stream; 

DESCRIPTION 

Puts writes the null-terminated string pointed to by s, followed by a newline 
character, to the standard output stream stdout. 

Fputs writes the null-terminated string pointed to by s to the named output stream. 

Neither function writes the terminating null character. 

DIAGNOSTICS 

Both routines return EOF on error. This occurs if the routines try to write on a file 
that has not been opened for writing. 

NOTE 

Puts appends a newline character while j^Mr.s does not. 

SEE ALSO 

ferrorO, fopenO, freadO, printfO, putcO, stdioO. 
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NAME 

rand, srand — simple random-number generator 

SYNOPSIS 

int rand ( ) 

void srand (seed) 
unsigned seed; 

DESCRIPTION 

Rand uses a multiplicative congruential random-number generator with period 2^^ 
that returns successive pseudorandom numbers in the range from to 2^5-1. 

Srand can be called at any time to reset the random-number generator to a specific 
seed. The generator is initially seeded with a value of 1. 

SEE ALSO 

randomxO . 
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NAME 

read — ^read from file 

SYNOPSIS 

int read(fildes, buf, nbyte) 
int fildes; 
char *buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat() or open() call. 

Read attempts to read nbyte bytes from the file associated W\\h fildes into the 
buffer pointed to by buf. 

On devices capable of seeking, the read starts at a position in the file given by the 
file pointer associated Wi\h fildes. Upon return from read, the file pointer is 
incremented by the number of bytes actually read. 

Nonseeking devices always read from the current position. The value of a file 
pointer associated with such a file is undefined. 

Upon successful completion, read returns the number of bytes actually read and 
placed in the buffer; this number may be less than nbyte if the file is associated 
with a window or if the number of bytes left in the file is less than nbyte bytes. A 
value of is returned when an end-of-file has been reached. 

Read fails if fildes is not a valid file descriptor open for reading, [ebadf] 

RETURN VALUE 

Upon successful completion a nonnegative integer is returned indicating the number 
of bytes actually read. Otherwise, -1 is returned and errno is set to indicate the 
error. 

SEE ALSO 

creatO, open(), stdio(). 
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NAME 

scanf , fscanf, sscanf — convert formatted input 

SYNOPSIS 

#include <std.io.h> 

int scanf (format [ , pointer ] ... ) 
char * format; 

int fscanf (stream, foinnat [ , pointer ] ... ) 
FILE * St ream; 
char * format; 

int sscanf (s, format [ , pointer ] ... ) 
char *s, *format; 

DESCRIPTION 

Scan/ reads characters from the standard input stream stdin. Fscanf re^ids 
characters from the named input stream, stream. Sscanf Teads characters from the 
character string s. Each function converts the input according to a control string 
(format) and stores the results according to a set of pointer arguments that indicate 
where the converted output should be stored. 

Format, the control string, contains specifications that control the interpretation of 
input sequences. The control string consists of characters to be matched in the input 
stream and/or conversion specifications that start with %. The control string may 
contain: 

• White-space characters (blanks and tabs) that cause input to be read up to 
the next non-white-space character, except as described below. 

• A character (any except %) that must match the next character of the input 
stream. To match a % character in the input stream, use "%%". 

• Conversion specifications begiiming with the character % and followed by 
an optional assignment suppression character *, an optional numeric 
maximum field width, an optional 1, m, n, or h indicating the size of the 
receiving variable, and a conversion code. 

An input field is defined relative to its conversion specification. The input field ends 
when the first character inappropriate for conversion is encountered or when the 
specified field width is exhausted. After conversion, the input pointer points to the 
inappropriate character. 

A conversion specification directs the conversion of the next input field; the result is 
placed in the variable pointed to by the corresponding argument, which is a pointer to 
a basic C type such as int or float. 

Assignment can be suppressed by preceding a format character with a *. 
Assignment suppression causes an input field to be skipped; the field is read and 
converted but not assigned. Therefore pointer should be omitted when assignment 
of the corresponding input field is suppressed. 
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The format character dictates the interpretation of the input field. The following 
format characters are legal in a conversion specification, after %: 

% A single % is expected in the input at this point; no assignment is done. 

The conversion characters d,u,o, and x may be 
preceded by I or h to indicate that a pointer to long 
or short, rather than int, is in the argument list. The 
I is ignored in this implementation because ints and 
longints are both 32 bits. 

d A decimal integer is expected; the corresponding argument should be an 

integer pointer. 

u An unsigned decimal integer is expected; the corresponding argument 

should be an unsigned integer pointer. 

o An octal integer is expected; the corresponding argument should be an 

integer pointer. 

X A hexadecimal integer is expected; the corresponding argument should 

be an integer pointer. 

The conversion characters €,f, and g may be 
preceded by l,m, or n to indicate that a pointer to 
double, comp, or extended, rather than float, is in 
the argument list. 

e ,f ,g A floating-point number is expected; the next field is converted 

accordingly and stored through the corresponding argument, which 
should be a pointer to a float, double, comp, or extended, depending on 
the size specification. The input format for floating-point numbers is an 
optionally signed string of digits, possibly containing a decimal point, 
followed by an optiond exponent field consisting of "E" or "e" followed 
by an optionally signed integer. In addition, infinity is represented by 
the string "INF', and NaNs are represented by the string "NAN", 
optionally followed by parentheses which may contain a string of digits 
(tiie NaN code). Case is ignored in the infinity and NaN strings. 

s A character string is expected; the corresponding argument should be a 

character pointer to an array of characters large enough to accept the 
string; a terminating null character (\0) is added automatically. The input 
field is terminated by a white-space (blank or tab) character. 

c A character is expected; the corresponding argument should be a 

character pointer. The normal skip over white space is suppressed in 
this case; to read the next non-white-space character, use "%ls". If a 
field width is given, the corresponding argument should refer to a 
character array ; the indicated number of characters is read. 

[ The left bracket introduces a scanset format. The input field is the 

maximal sequence of input characters consisting entirely of characters in 
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the scanset. When reading the input field, string data and the normal 
skip over leading white space are suppressed. TTie corresponding 
pointer argument must point to a character array large enough to hold the 
input field and the terminating null character (\0), which will be added 
automatically. The left bracket is followed by a set of characters (the 
scanset) and a terminating right bracket. 

The circumflex (^), when it appears as the first 
character in the scanset, serves as a complement 
operator and redefines the scanset as the set of all 
characters not contained in the remainder of the 
scanset string. 

The right bracket (]) ends the scanset. To include 
the right bracket as an element of the scanset, it must 
appear as the first character (possibly preceded by a 
circumflex) of the scanset; otherwise it will be 
interpreted syntactically as the closing bracket. 

A range of characters may be represented by the con%\x\xci first-last; 
thus the scanset [0123456789] may be expressed [0-9]. To use this 
convention, /ir5f must be less than or equal to last in the ASCII 
collating sequence; otherwise the minus (-) will stand for itself in the 
scanset The minus will also stand for itself whenever it is the first or 
the last character in the scanset. 

5ca«/ conversion terminates at EOF, at the end of the control string, or when an 
input character doesn't match the control string. In the latter case, the unmatched 
character is left unread in the input stream. 

^cart/returns the number of successfully matched and assigned input items; this 
number can be zero when an early mismatch between an input character and the 
control string occurs. If the input ends before the first mismatch or conversion, EOF 
is returned. 

EXAMPLES 

Example 1. The call 

int i; float x; char name [50]; 
scanf ("%d%f%s", &i, &x, name) ; 

with input 

25 54.32E-1 hartwell 

will assign the value 25 to /, and the value 5.432 to x; name will contain 
"hartwemO". 

Example! The call 

int i; extended x; char name [50]; 

scanf ("%2d%nf%*d %[0-9]", &i, &x, name); 
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with input 

56789 0123 56a72 

will assign 56 to i, 789.0 to Xy skip 0123, and place the string "56\0" in nafne. The 
next call to getcharQ wiU return "a". 

Examples. The call 

int i; 

scanf ("answerl=%d", &i) ; 

with input 

answerl=51 answer2=45 

will assign the value 51 to i since " answer 1" is matched explicitly in the input stream; 
the input pointer will be left at the space before "answer2". 

DIAGNOSTICS 

These functions return EOF on end of input and a short count for missing or illegal 
data items. 

NOTE 

Trailing white space is left unread unless matched in the control string. 

The success of literal matches and suppressed assignments is not directly 
determinable. 

SEE ALSO 

atofO, dec2num(), getcO, printfO, stdioO, str2dec(), strtol(). 
Apple Numerics Manual. 
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NAME 

setbuf — assign buffering to a stream 

SYNOPSIS 

#include <stdio.h> 

void setbuf (stream, buf) 
FILE *streain; 
char *buf; 

DESCRIPTION 

Setbuf is used after a stream has been opened but before it is read or written. 
Setbuf causes the character array pointed to by buf to be used instead of an 
automatically allocated buffer. If buf is a null character pointer, input/output will 
be completely unbuffered. 

BUFSIZ, a constant defined in the <stdio.h> header file, indicates how big an array 
is needed: 

char buf [BUFSIZ] ; 

A buffer is normally obtained from malloc() at the time of the first getc() or putc() 
on the file, except tfiat the standard error stream stderr is normally not buffered. 

Output streams directed to windows are either line-buffered or unbuffered. 

NOTE 

A common error is to allocate buffer space as an "automatic" variable in a code 
block and then fail to close the stream in the same block. 

SEE ALSO 

fopenO, getcO, mallocO, putcO- 
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NAME 

sinh, cosh, tanh — ^hyperbolic functions 

SYNOPSIS 

#include <math.h> 

extended sinh (x) 
extended x; 

extended cosh (x) 
extended x; 

extended tanh (x) 
extended x; 

DESCRIPTION 

Sinh, cosh, and tanh return, respectively, the hyberbolic sine, cosine, and 
tangent of their argument. 

DIAGNOSTICS 

Sinh, cosh, and tanh honor the floating-point exception flags — invalid 
operation, underflow, overflow, divide by zero, and inexact — as prescribed by the 
Standard Apple Numeric Environment (SANE). 

SEE ALSO 

Apple Numerics Manual. 
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NAME 

stdio — standard buffered input/output package 

SYNOPSIS 

#include <stdio.h> 

FILE *stdin, *stdout, *stderr; 

DESCRIPTION 

The standard I/O package constitutes an efficient user-level I/O buffering scheme. 
The inline macros getcQ and putc() handle characters quickly. The macros 
getcharO andputchar(), and the higher-level routines fgetcQ, fgets(), fprintf(), 
fputcO, fputsO, freadQ, fscanf(), fwrite(), gets(), getwQ, printf(), puts(), putw(), 
and scanfO all use getc() and putcQ; they can be freely intermixed. 

Any program that uses the standard I/O package must include the header file of 
pertinent macro definitions. The functions and constants mentioned in the standard 
I/O package are declared in the header file and need no further declaration. The 
header file is included as follows: 

♦include <stdio.h> 

A file with associated buffering is called a stream and is declared to be a pointer to 
a defined type FILE. Fopen() creates certain descriptive data for a stream and 
returns a pointer to designate the stream in aU further transactions. Normally, there 
are three open streams with constant pointers declared in the <stdio.h> header file 
and associated with the standard open files: 

stdin (standard input file) 

stdout (standard output file) 

stderr (standard error file) 

A constant NULL (0) designates a nonexistent pointer. 

An integer constant EOF (-1) is returned upon end-of-file or error by most integer 
functions that deal with streams. See the descriptions of the individual functions 
for details. 

The constants and the following functions are implemented as macros: getc(), 
getcharO, putc(), putchar(), feof(), ferror(), clearerr(), and fileno(). Redeclaration 
of these names should be avoided. 



NOTE 



<Stdio.h> includes definitions other than those described above, but their use is not 
recommended. 



DIAGNOSTICS 

Invalid stream pointers cause serious errors, possibly including program 
termination. Individual function descriptions describe the possible error conditions. 
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SEE ALSO 

openO, close 0, IseekO, readO, write (), fcloseO, ferrorO, 
fopenO, freadO, fseekO, getcO, getsO, printfO, putcO, 
putsO, scanfO, setbufO, ungetcO. 
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NAME 

strcat, stmcat, strcmp, stmcmp, strcpy, stmcpy, strlen,strchr, strrchr 
— string operations 

SYNOPSIS 

char *strcat (si, s2) 
char *sl, *s2; 

char *strncat (si, s2, n) 
char *sl, *s2; 
int n ; 

int strcmp (si, s2) 
char *sl, *s2; 

int strncmp (si, s2, n) 
char *sl, *s2; 
int n ; 

char *strcpy (si, s2) 
char *sl, *s2; 

char *strncpy (si, s2, n) 
char *sl, *s2; 
int n ; 

int strlen (s) 
char *s; 

char *strchr (s, c) 
char *s, c; 

char *strrchr (s, c) 
char *s, c; 

DESCRIPTION 

The arguments sl,s2, and s point to strings (arrays of characters terminated by a 
null character). The functions strcat, stmcat, strcpy, and strncpy all alter .y7 . 
These functions do not check for overflow of the array pointed to by si. 

Strcat appends a copy of string s2 to the end of string si. Strncat appends at 
most n characters. Each function returns a pointer to the null-terminated result. 

Strcmp performs a comparison of its arguments according to the ASCII collating 
sequence and returns an integer less than, equal to, or greater than when si is 
less than, equal to, or greater than s2, respectively. Strncmp makes the same 
comparison but looks at a maximum of n characters. 

Strcpy copies string s2 to string si, stopping after the null character has been 
copied. Strncpy copies exactly n characters, truncating s2 or adding null 
characters to si if necessary. The result is not null-terminated if the length of s2 is 
n or more. Each function returns si. 

Strlen returns the number of characters in s, not including the terminating null 
character. 
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Strchr (strrchr) returns a pointer to the first (last) occurrence of character c in 
string s; it returns a null pointer if c does not occur in the string. The null character 
terminating a string is considered to be part of the string. In previous versions of 
the Standard C Library, strchr was known as index() and strrchr was known as 
rindexQ. 

WARNING 

Overlapping moves may yield unexpected results. 
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NAME 

sin, cos, tan, asin, acos, atan, atan2 
— ^trigonometric functions 

SYNOPSIS 

#include <math.h> 

extended sin (x) 
extended x; 

extended cos (x) 
extended x; 

extended tan (x) 
extended x; 

extended asin (x) 
extended x; 

extended acos (x) 
extended x; 

extended atan (x) 
extended x; 

extended atan2 (y, x) 
extended x, y; 

DESCRIPTION 

Sin, cos, and tan return, respectively, the sine, cosine, and tangent of their 
argument, which is in radians. 

Asin returns the arcsine of jc, in the range -n/2 to n/2, 

Acos returns the arccosine of jc, in the range to n. 

Atan returns the arctangent of jc, in the range -n/2 to 11/2. 

Atanl returns the arctangent oiylx, in the range -% to 7C, using the signs of both 
arguments to determine the quadrant of the return value. 

For special cases, these functions return a NaN or infinity as appropriate. 

DIAGNOSTICS 

These functions honor the floating-point exception flags — ^invalid operation, 
underflow, overflow, divide by zero, and inexact — ^as prescribed by the Standard 
Apple Numeric Environment (SANE). 

NOTE 

Sin, cos, and tan have periods based on the nearest extended-precision 
representation of mathematical k. Hence these functions diverge from their 
mathematical counterparts as their argument becomes far from zero. 

SEE ALSO 

Apple Numerics Manual. 
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NAME 

ungetc — ^push character back into input stream 

SYNOPSIS 

tinclude <stdio.h> 

int ungetc (c, stream) 

char c; 

FILE *stream; 

DESCRIPTION 

Ungetc inserts the character c into the buffer associated with an input stream. That 
character, c, will be returned by the next getc() call on that stream. Ungetc returns 
c and leaves the file stream unchanged. 

One character of pushback is guaranteed provided something has been read from 
the stream and the stream is actually buffered. 

If c equals EOF, ungetc does nothing to the buffer and returns EOF. 

FseekQ erases all memory of inserted characters. 

DIAGNOSTICS 

For ungetc to perform correctly, a read must have been performed prior to the call 
of the ungetc function. Ungetc returns EOF if it can't insert the character. If 
stream is stdin, ungetc allows exactly one character to be pushed back onto the 
buffer without a previous read statement 

SEE ALSO 

fseekO, getc(), setbufO. 
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NAME 

unlink — ^remove a file 

SYNOPSIS 

int unlink (path) 
char *path; 

DESCRIPTION 

Unlink deletes the file named by the pathname pointed to by path. 

RETURN VALUE 

Upon successful completion, a value of is returned. Otherwise, a value of -1 is 
returned and errno is set to indicate the error. 
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NAME 

write — ^write on a file 

SYNOPSIS 

int write (fildes, buf, nbyte) 
int fildes; 
char *buf; 
unsigned nbyte; 

DESCRIPTION 

Fildes is a file descriptor obtained from a creat() or open() call. 

Write attempts to write nbyte bytes from the buffer pointed to by bufXo the file 
associated with the fildes. Internal limitations may cause write to write fewer 
bytes than requested; the number of bytes actually written is indicated by the return 
value. Several calls to write may therefore be necessary to write out the contents 
of buf. 

On devices capable of seeking, the actual writing of data proceeds from the position 
in the file indicated by the file pointer. Upon return from write, the file pointer is 
incremented by the number of bytes actually written. 

On nonseeking devices, writing always starts at the current position. The value of a 
file pointer associated with such a device is undefined. 

If the 0_APPEND file status flag is set — ^see open() — the file pointer is set to end- 
of-file prior to each write. 

Write fails and the file pointer remains unchanged if fildes is not a valid file 
descriptor open for writing, [ebadf] 

If you try to write more bytes than there is room for on the device, write writes as 
many bytes as possible. For example, if nbyte is 512 and there is room for 20 
bytes more on the device, write writes 20 bytes and returns a value of 20. The 
next attempt to write a nonzero number of bytes will signd an error, [enospc] 

RETURN VALUE 

Upon successful completion the number of bytes actually written is returned. 
Otherwise, -1 is returned and errno is set to indicate the error. 

SEE ALSO 

creatO, Iseek ( ) , open(). 
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7. Macintosh Interface Libraries 



This section contains the C definition of the Macintosh Interface Libraries. For complete documentation of 
these libraries, see Inside Macintosh. 

This section is arranged alphabetically by library name. The Library Index, Section 8, indexes the defines, 
types, enumeration literals, global variables, and functions defined here and in the Standard C Library. 
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NAME 



C interface to the Macintosh libraries 



SYNOPSIS 

♦include 
#include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 
♦include 



<types .h> 
<st rings .h> 
<resources .h> 
<quickdraw . h> 
<fonts .h> 
<events •h> 
<windows .h> 
<controls .h> 
<inenus . h> 
<textedit .h> 
<dialogs .h> 
<desk.h> 
<scrap.h> 
<toolutils.h> 
<printing.h> 
<osutils .h> 
<memory .h> 
<segload.h> 
<osevents .h> 
<files.h> 
<devices .h> 
<disks .h> 
<sound.h> 
<retrace.h> 
<serial .h> 
<packages .h> 
<error .h> 
<sane .h> 



/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 



common defines and types 

string conversions 

Resource Manager 

QuickDraw 

Font Manager 

Event Manager 

Window Manager 

Control Manager 

Menu Manager 

TextEdit 
/* Dialog Manager 
/* Desk Manager 
/* Scrap Manager 
/* Toolbox Utilities 
/* Printing Manager 
/* Operating System Utilities 
/* Memory Manager 
/* Segment Loader 

OS Event Manager 

File Manager 

Device Manager 

Disk Driver 

Sound Driver 
/* Vertical Retrace Manager 
/* Serial Drivers 
/* packages 

/* System Error Handler 
/* SANE Numerics 






*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 

*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 



DESCRIPTION 

The C Interface provides C programs with access to all of the libraries defined in 
Inside Macintosh. Constants, types, and library routines are provided. The list 
of libraries appears above. 

Header Files — Include the ".h" files in C programs to declare the defines, types, 
and functions provided by these libraries. Each library definition lists the includes 
necessary for use of that library. Functions whose declarations can be inferred 
from calls have been omitted from the header files. List the includes in the order in 
which the libraries are listed above. 

Object File — ^The interface code is contained in file interface.obj. Link this file with 
the C program and other libraries. Not all functions require interface code. The 
linker includes interface code for only those routines that are called. 

Interface Implementation — ^Most library routines are declared as external Pascal 
routines with trap numbers, and are trapped to directly by compiled code. Other 
routines are declared to be C routines and are called through interface glue. 

Parameter Types — ^The C interfaces expect structures (including Points) to be 
passed by address. String parameters are C strings (i.e., zero-terminated) unless 



Page 69 



Interface Macintosh Interface Libraries Interface 



otherwise indicated. ResTypes and OSTypes can be expressed as character literals 
(e.g., 'MENU'). 

Spelling and Capitalization — The spelling and capitalization of identifiers is exactly 
as specified in Inside Macintosh. Constants, variables, parameter names, fields 
within structures, and enumeration-type elements begin with a lowercase letter. 
Routines and data types begin with an uppercase letter. Letters that begin new 
words in English are capitalized. All other letters are lowercase. When a name 
includes an acronym, the case of the entire acronym is determined by the case of the 
first letter (e.g., GetOSEvent, teJustLeft). 
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NAME 

controls — Control Manager 



SYNOPSIS 

#include <types.h> 
#include <controls.h> 



/* Control Definition Procedures IDs */ 

#define pushButProc 

tdefine checkBoxProc 1 

fdefine radioButProc 2 

#define useWFont 8 

#define scrollBarProc 16 

/* FindControl Result Codes */ 

#define inButton 10 

#define inCheckbox 11 

♦define inUpButton 20 

#define inDownButton 21 

#define inPageUp 22 

♦define inPageDown 23 

♦define inThumb 12 9 

/* DragControl Axis Constraints */ 

♦define noConstraint 
♦define hAxisOnly 1 
♦define vAxisOnly 2 

/* Messages to Control definition function */ 

♦define drawCntl 

♦define testCntl 1 

♦define calcCRgns 2 

♦define initCntl 3 

♦define dispCntl 4 

♦define posCntl 5 

♦define thumbCntl 6 

♦define dragCntl 7 

♦define autoTrack 8 



typedef struct ControlRecord { 

struct ControlRecord **nextControl; 
struct GrafPort *contrlOwner/ 
Rect contrlRect; 

unsigned char contrlVis; 
unsigned char contrlHilite; 
short contrlValue; 

short contrlMin; 

short contrlMax; 

ProcHandle contrlDefProc; 
Handle contrlData; 
ProcPtr contrlAction; 



Page 71 



CONTROLS Macintosh Interface Libraries CONTROLS 



long contrlrfCon; 

Str255 contrlTitle; 



} ControlRecord, *ControlPtr, **ControlHandle; 



/* Initialization and Allocation */ 

ControlHandle NewControl (theWindow,boundsRect, title, visible, value, 
min, max, procID, ref Con) 

struct GrafPort *theWindow; 

Rect *boundsRect; 

char *title; 

Boolean visible; 

short value; 

short min; 

short max; 

short procID; 

long re f Con; 
pascal ControlHandle GetNewControl (controlID, theWindow) 

short controlID; 

struct GrafPort *theWindow; 
pascal void DisposeControl (theControl) 

ControlHandle theControl; 
pascal void KillControls (theWindow) 

struct GrafPort *theWindow; 

/* Control Display */ 

void SetCTitle (theControl, title) 

ControlHandle theControl; 

char *title; 
void GetCTitle (theControl, title) 

ControlHandle theControl; 

char *title; 
pascal void HideControl (theControl) 

ControlHandle theControl; 
pascal void ShowControl (theControl) 

ControlHandle theControl; 
pascal void DrawControls (theWindow) 

struct GrafPort *theWindow; 
pascal void HiliteControl (theControl, hiliteState) 

ControlHandle theControl; 

short hiliteState; 

/* Mouse Location */ 

short TestControl (theControl, thePoint) 

ControlHandle theControl; 

Point *thePoint; 
short FindControl (thePoint, theWindow, theControl) 

Point *thePoint; 

struct GrafPort *theWindow; 

ControlHandle *theControl; 
short TrackControl (theControl, startPt, actionProc) 

ControlHandle theControl; 

Point *startPt; 

ProcPtr actionProc; 
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/* Control Movement and Sizing */ 

pascal void MoveControl (theControl,h, v) 

ControlHandle theControl; 

short h,v; 
void DragControl (theControl, startPt, limitRect , slopRect, axis) 

ControlHandle theControl; 

Point *startPt; 

Rect *limitRect; 

Rect *slopRect; 

short axis; 
pascal void SizeControl (theControl, w,h) 

ControlHandle theControl; 

short w,h; 

/* Control Settings and Range */ 

pascal void SetCtlValue (theControl, theValue) 

ControlHandle theControl; 

short theValue; 
pascal short GetCtlValue (theControl) 

ControlHandle theControl; 
pascal void SetCtlMin (theControl, minValue) 

ControlHandle theControl; 

short minValue; 
pascal short GetCtlMin (theControl) 

ControlHandle theControl; 
pascal void SetCtlMax (theControl, maxValue) 

ControlHandle theControl; 

short maxValue; 
pascal short GetCtlMax (theControl) 

ControlHandle theControl; 

/* Miscellaneous Utilities */ 

pascal void SetCRefCon (theControl, data) 

ControlHandle theControl; 

long data; 
pascal long GetCRef Con (theControl) 

ControlHandle theControl; 
pascal void SetCtlAction (theControl, actionProc) 

ControlHandle theControl; 

ProcPtr actionProc; 
pascal ProcPtr GetCtlAction (theControl) 

ControlHandle theControl; 



USER ROUTINES 

pascal void MyActionO 

pascal void My Action (theControl, partCode) 

ControlHandle theControl; 

short partCode; 

pascal long MyControl (varCode, theControl, message, param) 
short varCode; 
ControlHandle theControl; 
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short message; 
long pa rare; 

DESCRIPTION 

The Control Manager provicjes routines for creating and manipulating controls 
(e.g., buttons, scroll bars). 

For more detailed information see the Control Manager chapter of Inside 
Macintosh. 
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NAME 

desk — ^Desk Manager 

SYNOPSIS 

#include <types.h> 
# include <desk.h> 

/* Opening and Closing Desk Accessories */ 

short OpenDeskAcc (theAcc) 

char *theAcc; 
pascal void CloseDeskAcc (refNum) 

short refNum; 

/* Handling Events in Desk Accessories */ 

pascal void SystemClick (theEvent, theWindow) 

struct EventRecord *theEvent; 

struct GrafPort *theWindow; 
pascal Boolean SystemEdit (editCmd) 

short editCmd; 

/* Performing Periodic Actions */ 
pascal void SystemTaskO 
/* Advanced Routines */ 

pascal Boolean SystemEvent (theEvent) 

struct EventRecord *theEvent; 
pascal void SystemMenu (menuResult) 

long menuResult; 

DESCRIPTION 

The Desk Manager supports desk accessories. 

Warning: The names of desk accessories start with a null byte. The output 
parameter from GetMenuItem will return a string that begins with a null byte when 
a desk accessory is selected from the Apple menu. OpenDeskAcc skips over this 
null byte when interpreting its parameter. 

For more detailed information see the Desk Manager chapter of Inside 
Macintosh. 

NOTE 

Desk accessories do not have an A5 global area. Therefore all of the code for a 
desk accessory must reside in a single sement; no global variables may be declared; 
and no string constants may be used. 
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NAME 



devices — ^Device Manager 



SYNOPSIS 

#include <types.h> 
finclude <osutils.h> 
#include <devices.h> 



/* error codes */ 



#define 
#define 
tdefine 
#define 
fdefine 
#define 
#define 
#def ine 

♦define 
fdefine 
#define 



abortErr 

badUnitErr 

controlErr 

dInstErr 

dRemoveErr 

noErr 

notOpenErr 

openErr 



readErr (-19) 
statusErr (-18) 
unitEmptyErr (-22) 



tdefine writErr 



(-27) /* I/O request aborted by KilllO */ 
(-21) /* RefNum doesn't match unit table */ 
(-17) /* Driver can't respond to this call */ 
(-26) /* Couldn't find driver in resource file */ 
(-25) /* Tried to remove an open driver */ 

/* No error */ 
(-28) /* Driver isn't open */ 
(-23) /* Requested r/w permission doesn't */ 
match driver's open permission */ 
Driver can't respond to Read calls */ 
Driver can't respond to Status call */ 
Reference number specifies nil handle */ 
in uhit table */ 
(-20) /* Driver can't respond to Write calls */ 



/* 
/* 
/* 
/* 
/* 
/* 



typedef struct CntrlParam { 
struct QElem *qLink; 



short 


qType; 


short 


ioTrap; 


Ptr 


ioCmdAddr; 


ProcPtr 


ioCompletion; 


OSErr 


ioResult; 


char 


*ioNamePtr; 


short 


ioVRefNum; 


short 


ioCRefNum; 


short 


csCode; 


short 


csParam[ll] 


CntrlParam; 





/* next queue entry */ 

/* queue type */ 

/* routine trap */ 

/* routine address */ 

/* completion routine */ 

/* result code */ 

/* volume or file name */ 

/* volume refnum or drive number * 

/* refnum for I/O operations */ 

/* word for control status code */ 

/* operation-defined parameters */ 



/ 



typedef struct DCtlEntry { 



Ptr 


dCt ID river ; 


short 


dCtlFlags; 


QHdr 


dCtlQHdr; 


long 


dCtlPosition; 


Handle 


dCtlStorage; 


short 


dCtlRefNum; 


long 


dCtlCurTicks; 


Ptr 


dCtlWindow; 


short 


dCtlDelay; 


short 


dCtlEMask; 


short 


dCtlMenu; 


} DCtlEntry, 


*DCtlPtr, **DC 



/* ptr to ROM or handle to RAM driver */ 

/* flags */ 

/* driver's I/O queue */ 

/* byte pos used by read and write */ 

/* handle to RAM driver's storage */ 

/* driver's reference number */ 

/* counter for timing system task calls */ 

/* ptr to driver's window (if any) */ 

/* # of ticks between sysTask calls */ 

/* desk accessory event mask */ 

/* menu ID of menu associated w/ driver */ 
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/* High-Level Routines */ 

OSErr OpenDriver (name, refNum) 

char *name; 

short *refNum; 
OSErr CloseDriver (refNum) 

short refNum; 
OSErr Control (refNum, csCode, csParam) 

short refNum, csCode; 

Ptr csParam; 
OSErr Status ( refNum, csCode,csParam) 

short refNum, csCode; 

Ptr csParam; 
OSErr KilllO (refNum) 

short refNum; 



/* Low-Level Routines */ 

OSErr PBControl (paramBlock, async) 

CntrlParam *paramBlock; 

Boolean async; 
OSErr PBStatus (paramBlock, async) 

CntrlParam *paramBlock; 

Boolean async; 
OSErr PBKilllO (paramBlock, async) 

CntrlParam *paramBlock; 

Boolean async; 



/* Accessing a Driver's I/O Queue */ 

DCtlHandle GetDCtlEntry (refNum) 
short refNum; 



DESCRIPTION 

The Device Manager controls the exchange of information between an application 
and devices. 

For more detailed information see the Device Manager chapter of Inside 
Macintosh. 
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NAME 



dialogs — ^Dialog Manager 



SYNOPSIS 

finclude <types.h> 
finclude <quickdraw.h> 
#include <windows.h> 
finclude <dialogs.h> 

/* Item types */ 



fdefine 


ctrlltem 


4 


/* 


#define 


btnCtrl 





/* 


#define 


chkCtrl 


1 


/* 


tdefine 


radCtrl 


2 


/* 


#def ine 


resCtrl 


3 


/* 


#def ine 


statText 


8 


/* 


#define 


editText 


16 


/* 


#define 


iconltem 


32 


/* 


# define 


picltem 


64 


/* 


#define 


userltem 





/* 


♦define 


itemDisable 


128 


/* 



add to following four constants */ 

standard button control */ 

standard check box control */ 

standard "radio button" control */ 

control defined in control template */ 

static text */ 

editable text (dialog only) */ 

icon */ 

Quickdraw picture */ 
application-defined item (dialog only) */ 

add to any of above to disable */ 



/* Item numbers of OK and Cancel buttons */ 



♦define ok 
♦define cancel 



/* OK button is first by convention */ 
/* Cancel button is second by convention */ 



/* Resource IDs of Alert icons */ 

♦define stoplcon 
♦define notelcon 1 
♦define ctnlcon 2 



typedef WindowPtr DialogPtr; 
typedef struct DialogRecord { 

WindowRecord window; 

Handle items ; 

struct TERec **textH; 



short 
short 
short 
} DialogRecord, 



editField; 
editOpen; 
aDefltem; 
*DialogPeek; 



typedef struct DialogTemplate { 

Rect boundsRect ; 

short procID; 

Boolean visible; 

Boolean fillerl; 

Boolean goAwayFlag; 

Boolean filler2; 

long refCon; 

short items ID; 

Str255 title; 
} DialogTemplate, *DialogTPtr, **DialogTHndl; 
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typedef long StageList; 

typedef struct AlertTemplate { 

Rect boundsRect; 

short items ID; 

StageList stages; 
} AlertTemplate, *AlertTPtr, **AlertTHndl; 



/* Initialization */ 

pascal void InitDialogs (restartProc) 

ProcPtr restartProc; 
pascal void ErrorSound(soundProc) 

ProcPtr soundProc; 
void SetDAFont (fontNum) 

short fontNum; 

/* Creating and Disposing of Dialogs */ 

DialogPtr NewDialog (dStorage, boundsRect , tit le, visible, procID, behind, 
goAwayFlag, refCon, items) 

Ptr dStorage; 

Rect *boundsRect; 

char *title; 

Boolean visible; 

short procID; 

WindowPtr behind; 

Boolean goAwayFlag; 

long re f Con; 

Handle items ; 
pascal DialogPtr GetNewDialog(dialogID, dStorage, behind) 

short dialogID; 

Ptr dStorage; 

WindowPtr behind; 
pascal void CloseDialog(theDialog) 

DialogPtr theDialog; 
pascal void DisposDialog (theDialog) 

DialogPtr theDialog; 
pascal void CouldDialog (dialogID) 

short dialogID; 
pascal void FreeDialog (dialogID) 

short dialogID; 

/* Handling Dialog Events */ 

pascal void ModalDialog(filterProc,itemHit) 

ProcPtr filterProc; 

short *itemHit; 
pascal Boolean IsDialogEvent (theEvent) 

struct EventRecord *theEvent; 
pascal Boolean DialogSelect (theEvent, theDialog, itemHit) 

struct EventRecord *theEvent; 

DialogPtr *theDialog; 

short * itemHit; 
void DlgCut (theDialog) 
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DialogPtr theDialog; 
void DlgCopy (theDialog) 

DialogPtr theDialog; 
void DlgPaste (theDialog) 

DialogPtr theDialog; 
void DlgDelete (theDialog) 

DialogPtr theDialog; 
pascal void DrawDialog (theDialog) 

DialogPtr theDialog; 

/* Invoking Alerts */ 

pascal short Alert (alertID,filterProc) 

short alertlD; 

ProcPtr filterProc; 
pascal short StopAlert (alertID, filterProc) 

short alertID; 

ProcPtr filterProc; 
pascal short NoteAlert (alertID, filterProc) 

short alertID; 

ProcPtr filterProc; 
pascal short CautionAlert (alertID, filterProc) 

short alertID; 

ProcPtr filterProc; 
pascal void CouldAlert (alertID) 

short alertID; 
pascal void FreeAlert (alertID) 

short alertID; 

/* Manipulating Items in Dialogs and Alerts */ 

void ParamText (paramO , paraml , param2 , paramS ) 

char *paramO; 

char *paraml; 

char *parain2; 

char *param3; 
pascal void GetDItem (theDialog, itemNo, type, item, box) 

DialogPtr theDialog; 

short itemNo; 

short *type; 

Handle *item; 

Rect *box; 
pascal void SetDItem(theDiarog, itemNo, type, item, box:) 

DialogPtr theDialog; 

short itemNo; 

short type; 

Handle item; 

Rect *box; 
void Get IText (item, text) 

Handle item; 

char *text; 
void Set IText (item, text) 

Handle item; 

char *text; 
pascal void SellText (theDialog, itemNo, startSel,endSel) 

DialogPtr theDialog; 

short itemNo; 
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short start Self- 
short endSel; 

short GetAlrtStageO 

void ResetAlrtStage () 

USER ROUTINES 

pascal void MyItem(theWindow, itemNo) 

struct GrafPort *theWindow; 

short itemNo; 
pascal void MySound(soundNo) 

short soundNo; 
pascal Boolean MyFilter (theDialog, theEvent, iteitiHit) 

DialogPtr theDialog; 

struct EventRecord *theEvent; 

short *itemHit; 

DESCRIPTION 

The Dialog Manager supports dialog boxes and the alert mechanism. 

For more detailed information see the Dialog Manager chapter of Inside 
Macintosh. 

NOTE 

StageList is defined as a long, rather than specifying the bits. 
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NAME 



disks — ^Disk I>river 



SYNOPSIS 

#include <types.h> 
tinclude <disks.h> 



/* error codes */ 

fdefine firstDskErr 
#define lastDskErr 



fdefine 
# define 
# define 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 
fdefine 



badBtSlpErr 

badCksmErr 

badDBtSlp 

badDCksum 

cantStepErr 

dataVerErr 

initlWMErr 

noAdrMkErr 

noDriveErr 

noDtaMkErr 

noErr 

noNybErr 

nsDrvErr 

offLinErr 

paramErr 

sectNFErr 

seekErr 

spdAdjErr 

tkOBadErr 

twoSideErr 

wPrErr 

wrUnderrun 



-84) 
-64) 

-70) 
-69) 
-73) 
-72) 
-75) 
-68) 
-77) 
-67) 
-64) 
-71) 


-es) 

-56) 
■65) 
-50) 
■81) 
■80) 
■79) 
■76) 
■78) 
•44) 
-74) 



typedef struct DrvSts { 



short 
char 
char 
char 
char 
struct 
short 
short 
short 
short 
char 
char 
short 
} DrvSts; 



track; 
writeProt; 
disklnPlace; 
installed; 
sides; 
QElem *qLink; 
qType; 
dQDrive; 
dQRefNum; 
dQFSID; 
twoSideFmt; 
needsFlush; 
diskErrs; 



/* First of the range of disk errors */ 
/* Last of the range of disk errors */ 

/* Bad address mark */ 

/* Bad address mark */ 

/* Bad data mark */ 

/* Bad data mark */ 

/* Hardware error */ 

/* Read-verify failed */ 

/* Hardware error */ 

/* Can't find an address mark */ 

/* Drive isn't connected */ 

/* Can't find data mark */ 

No error */ 

Disk is probably blank */ 

No such drive */ 

No disk in drive */ 

Bad positioning information */ 
/* Can't find sector */ 
/* Hardware error */ 
/* Hardware error */ 
/* Hardware error */ 
/* Tried to read side 2, 
/* Disk is locked */ 
/* write underrun occurred */ 



/* 

/* 
/* 



on 1 side drive */ 



/* current track */ 

/* bit 7=1 if volume is locked */ 

/* disk in place */ 

/* drive installed */ 

/* bit 7=0 if single-sided drive */ 

/* next queue entry */ 

/* not used */ 

/* drive number */ 

/* driver reference number */ 

/* file-system identifier */ 

/* -1 if two-sided disk */ 

/* reserved */ 

/* error count */ 



OSErr DiskEject (drvNum) 

short drvNum; 
OSErr SetTagBuffer (buffPtr) 

Ptr buffPtr; 
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OSErr DriveStatus (drvNum, status) 
short drvNum; 
DrvSts *status; 



DESCRIPTION 

The Disk Driver is a Macintosh device driver used for storing and retrieving 
information on Macintosh 3 1/2-inch disk drives. 

For more detailed information see the Disk Driver chapter of Inside Macintosh, 
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NAME 



error — System Error Handler 



SYNOPSIS 

finclude <error.h> 

/* error codes */ 



#def ine 


dsBusErr 


1 


#define 


dsAddressErr 


2 


#define 


dsIllInstErr 


3 


#def ine 


dsZeroDivErr 


4 


#define 


dsChkErr 


5 


#define 


dsOvflowErr 


6 


#def ine 


dsPrivErr 


7 


#define 


dsTraceErr 


8 


fdefine 


dsLineAErr 


9 


fdefine 


dsLineFErr 


10 


#define 


dsMiscErr 


11 


fdefine 


dsCoreErr 


12 


#define 


dsIrqErr 


13 


#define 


dsIOCoreErr 


14 


fdefine 


dsLoadErr 


15 


fdefine 


dsFPErr 


16 


fdefine 


dsNoPackErr 


17 


fdefine 


dsNoPkl 


18 


fdefine 


dsNoPk2 


19 


fdefine 


dsNoPkS 


20 


fdefine 


dsNoPk4 


21 


fdefine 


dsNoPkS 


22 


fdefine 


dsNoPke 


23 


fdefine 


dsNoPk? 


24 


fdefine 


dsMemFullErr 


25 


fdefine 


dsBadLaunch 


26 


fdefine 


dsFSErr 


27 


fdefine 


dsStkNHeap 


28 


fdefine 


dsReinsert 


30 


fdefine 


dsNotThel 


31 


fdefine 


dsSysErr 


32767 



/* Bus Error 

/* Address Error 

/* Illegal Instruction 

/* Zero Divide 

/* Check Exception 

/* TrapV Exception 

/* Privilege Violation 

/* Trace Exception 

/* Line 1010 Exception 

/* Line 1111 Exception 

/* Miscellaneous Exception 

/* Unimplemented Core Rout 

/* Spurious Interrupt 

/* I/O System Error 

/* Segment Loader Error 

/* Floating Point Error 

/* Can't Load Package 

/* Can't Load Package 1 

/* Can't Load Package 2 

/* Can't Load Package 3 

/* Can't Load Package 4 

/* Can't Load Package 5 

/* Can't Load Package 6 

/* Can't Load Package 7 

/* Out of Memory 

/* Segment Loader Error 

/* File Map Trashed 

/* Stack Overflow Error 

/* Please Insert the Disk 

/* This is Not the Correct 

/* System Error 



me 



*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
*/ 
Disk */ 
*/ 



void SysError (errorCode) 
short errorCode; 



DESCRIPTION 

The System Error Handler is the part of the Macintosh Operating System that 
assumes control when a fatal error occurs. For more detailed information see the 
System Error Handler chapter of Inside Macintosh. 
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NAME 

events — ^Toolbox Event Manager 

SYNOPSIS 

finclude <types.h> 
#include <events.h> 

/* Event Types */ 

tdefine nullEvent 

#define mouseDown 1 

tdefine mouseUp 2 

fdefine keyDown 3 

tdefine keyUp 4 

fdefine autoKey 5 

#define updateEvt 6 

#define diskEvt 7 

#define activateEvt 8 

#define networkEvt 10 

#define driverEvt 11 

tdefine applEvt 12 

fdefine app2Evt 13 

fdefine app3Evt 14 

fdefine app4Evt 15 

/* Masks for accessing keyboard event message */ 



fdefine 


charCodeMask 


OxOOOOOOFF 


fdefine 


keyCodeMask 


OxOOOOFFOO 


/* Event 


Masks */ 




fdefine 


rtiDownMask 


2 


fdefine 


mUpMask 


4 


fdefine 


keyDownMask 


8 


fdefine 


keyUpMask 


16 


fdefine 


autoKeyMask 


32 


fdefine 


updateMask 


64 


fdefine 


diskMask 


128 


fdefine 


activMask 


256 


fdefine 


networkMask 


1024 


fdefine 


drive rMask 


2048 


fdefine 


applMask 


4096 


fdefine 


app2Mask 


8192 


fdefine 


app3Mask 


16384 


fdefine 


app4Mask (■ 


-32768) 


fdefine 


eve ryE vent 


(-1) 



/* Modifiers */ 

fdefine activeFlag 1 

fdefine btnState 128 

fdefine cmdKey 256 

fdefine shiftKey 512 

fdefine alphaLock 1024 

fdefine optionKey 2048 
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typedef struct EventRecord { 

short what; 

long message; 

long when; 

Point where; 

short modifiers; 
} EventRecord; 

typedef long KeyMap[4]; 



/* Accessing Events */ 

pascal Boolean GetNextEvent (eventMask,theEvent) 

short eventMask; 

EventRecord *theEvent; 
pascal Boolean Event Avail (eventMask, theEvent) 

short eventMask; 

EventRecord *theEvent ; 



/* Reading the Mouse */ 

pascal void GetMouse (mouseLoc) 

Point *mouseLoc; 
pascal Boolean Button () 
pascal Boolean StillDownO 
pascal Boolean WaitMouseUp () 

/* Reading the Keyboard and Keypad */ 

pascal void Get Keys (theKeys) 
KeyMap *theKeys; 

/* Miscellaneous Routines */ 

pascal long TickCountO 
long GetDblTimeO 
long GetCaretTimeO 

DESCRIPTION 

The Toolbox Event Manager provides access to the Macintosh keyboard, keypad, 
and mouse. The keyboard bit map returned by the function GetKeysQ is organized 
as shown below. Tlie bits aren't numbered as you might expect. Here is the actual 
numbering scheme, corresponding to the key code numbers given in the Key Codes 
figure in 5ie Toolbox Event Manager chapter of Inside Macintosh. 
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keyMap [ ] keyMap [ 1 ] keyMap [ 2 ] keyMap [ 3 ] 
I III 

I III 

V V V V 

bytes bO,bl,b2,b3 b4,b5, bl2,bl3,bl4,bl5 

I \ I 

I \ I 

V \ V 
bits 7,6,5,4,3,2,1,0 I 127,126,125,124,123,122,121,120 

V 

15,14,13,12,11,10,9,8 
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NAME 



files — ^File Manager 



SYNOPSIS 

#include <types.h> 
finclude <files.h> 



/* error codes */ 



#define 
#define 
fdefine 
#define 
#define 
#define 
tdefine 

#define 
#def ine 
fdefine 
#define 
#define 
#define 
#define 
#define 
fdefine 
tdefine 
#define 
#define 

#def ine 
#define 
#define 
tdefine 
#define 
#define 
#define 
tdefine 
tdefine 



badMDBErr 

bdNamErr 

dirFulErr 

dskFulErr 

dupFNErr 

eofErr 

extFSErr 

fBsyErr 

fLckdErr 

fnfErr 

fnOpnErr 

fsRnErr 

ioErr 

noErr 

nsDrvErr 

noMacDskErr 

nsvErr 

opWrErr 

paramErr 

permErr 

posErr 

rfNumErr 

tmfoErr 

volOffLinErr 

volOnLinErr 

vLckdErr 

wrPermErr 

wPrErr 



-60) 
-37) 
-33) 
■34) 
-48) 
-39) 
-58) 

-47) 
■45) 
■43) 
■38) 
■59) 
•36) 

■56) 
■57) 
■35) 
■49) 
-50) 

■54) 
-40) 
-51) 
-42) 
-53) 
-55) 
-46) 
-61) 
-44) 






/* Master directory block is bad, reinit */ 
/* Bad file or volume name (zero length?)*/ 
/* File directory full */ 
/* All allocation blocks are full */ 
/* File by that name already exists */ 
/* Logical EOF reached during read */ 
/* External file system; identifier is 
/* non-zero or refNum is > 1024 
/* One or more files are open */ 
/* File Locked */ 
/* File not found */ 
/* File not open */ 
/* Problem during rename */ 
/* Disk I/O error */ 
/* No error */ 

/* No such drive in the drive queue */ 
/* Volume lacks Mac-format directory */ 
/* Specified volume doesn't exist */ 
/* Only one writer allowed */ 
/* Parameter's don't specify an existing 
volume and there ' s no default volume 
Permission doesn't allow writing */ 
Attempted to position before start */ 
/* Bad reference number */ 
/* Only 12 files can be open at once */ 
/* Volume not on-line */ 

/* Volume is already mounted and on-line */ 
/* Volume is locked by a software flag */ 
/* Permission does not allow writing */ 
/* Volume is locked by a hardware setting */ 



/* 
/* 
/* 



*/ 
*/ 



/* Flags in file information used by the Finder */ 



tdefine 


fHasBundle 


8192 


tdefine 


f Invisible 


16384 


tdefine 


fTrash 


(-3) 


tdefine 


fDesktop 


(-2) 


tdefine 


fDisk 






/* set if file has a bundle */ 

/* set if file's icon is invisible */ 

/* file is in trash window */ 

/* file in on desktop */ 

/* file is in disk window */ 



/* Values for posMode and ioPosMode */ 



tdefine 


fsAtMark 





tdefine 


f sFromStart 


1 


tdefine 


fsFromLEOF 


2 



/* at current position of mark */ 

/* (posOff or ioPosOffset ignored) */ 

/* offset relative to beginning of file */ 

/* offset relative to logical EOF */ 
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#define fsFromMark 3 
#define rdVerify 64 



/* offset relative to current mark */ 
/* added to above for read-verify */ 



/* Values for requesting read/write access */ 



#define fsCurPerm 

#define fsRdPerm 1 

#define fsWrPerm 2 

#define fsRdWrPerm 3 



/* whatever is currently allowed */ 

/* request to read only */ 

/* request to write only */ 

/* request to read and write */ 



typedef struct FInfo { 



OSType 
OSType 
short 
Point 
short 
} FInfo; 



f dType ; 

fdCreator; 

fdFlags; 

fdLocation; 

fdFldr; 



/* the type of the file */ 

/* file's creator */ 

/* flags. hasBundle, invisible, etc. */ 

/* file's location in window */ 

/* folder containing file */ 



/* Parameter Blocks */ 



typedef struct lOParam { 
struct QElem *qLink; 



short 

short 

Ptr 

ProcPtr 

OSErr 

StringPtr 

short 

short 

char 

char 

Ptr 

Ptr 
long 
long 
short 
long 
} I OP a ram ; 



qType; 

ioTrap; 

ioCmdAddr; 

ioCompletion; 

ioResult; 

ioNamePtr; 

ioVRefNum; 

ioRefNum; 

ioVersNum; 

ioPermssn; 

ioMisc; 

ioBuffer; 
ioReqCount ; 
ioActCount ; 
ioPosMode; 
ioPosOffset; 



/* 
/* 






/* 
/* 
/* 
/* 
/* 



next queue entry */ 

queue type */ 

routine trap */ 
/* routine address */ 
/* completion routine */ 

result code */ 

volume of file name */ 
/* volume refnum or drive number */ 
/* path reference number */ 
/* version number */ 

read/ write permission */ 

miscellaneous (Note: use high byte */ 
for PBSetFVers) */ 

data buffer */ 

requested number of bytes */ 
/* actual byte count completed */ 
/* newline char and type of positioning */ 
/* size of positioning offset */ 



typedef struct FileParam { 
struct QElem *qLink; 



short 


qType; 


short 


ioTrap; 


Ptr 


ioCmdAddr; 


ProcPtr 


ioCompletion; 


OSErr 


ioResult; 


StringPtr 


ioNamePtr; 


short 


ioVRefNum; 


short 


ioFRefNum; 


char 


ioFVersNum; 


char 


fillerl; 



/* next queue entry */ 

/* queue type */ 

/* routine trap */ 

/* routine address */ 

/* completion routine */ 

/* result code */ 

/* volume of file name */ 

/* volume refnum or drive number */ 

/* path reference number */ 

/* version number */ 

/* not used */ 
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short 


ioFDirlndex; 


/* 


char 


ioFlAttrib; 


/* 


char 


ioFlVersNum; 


/* 


FInfo 


ioFlFndrlnfo; 


/* 


long 


ioFlNum; 


/* 


short 


ioFlStBlk; 


/* 


long 


ioFlLgLen; 


/* 


long 


ioFlPyLen; 


/* 


short 


ioFlRStBlk; 


/* 


long 


ioFlRLgLen; 


/* 


long 


ioFlRPyLen; 


/* 


long 


ioFlCrDat; 


/* 


long 


ioFlMdDat; 


/* 


} FileParam; 







sequence number of file */ 

/* file attributes */ 
version number */ 
information used by the Finder */ 
file number */ 
first block of data fork */ 
logical EOF of data fork */ 
phyisical EOF of data fork */ 
first block of resource fork */ 
logical EOF of resource fork */ 
physical EOF of resource fork */ 

/* date and time of creation */ 

date and time of last modification */ 



typedef struct VolumeParam { 



struct QEl 


em *qLink; 


/* 


short 


qType; 


/* 


short 


ioTrap; 


/* 


Ptr 


ioCmdAddr; 


/* 


ProcPtr 


ioCompletion; 


/* 


OSErr 


ioResult; 


/* 


StringPtr 


ioNamePtr; 


/* 


short 


ioVRefNum; 


/* 


long 


filler2; 


/* 


short 


ioVolIndex; 


/* 


long 


ioVCrDate; 


/* 


long 


ioVLsBkUp; 


/* 


short 


ioVAtrb; 


/* 


short 


ioVNmFls; 


/* 


short 


ioVDirSt; 


/* 


short 


ioVBlLn; 


/* 


short 


ioVNmAlBlks ; 


/* 


long 


ioVAlBlkSiz; 


/* 


long 


ioVClpSiz; 


/* 


short 


ioAlBlSt; 


/* 


long 


ioVNxtFNum; 


/* 


short 


ioVFrBlk; 


/* 


} VolumeParam 


/ 





next queue entry */ 
queue type */ 
routine trap */ 
routine address */ 
completion routine */ 
/* result code */ 

volume of file name */ 

volume refnum or drive number */ 

not used */ 

volume index */ 

date and time of initialization */ 

date and time of last volume backup */ 

bit 15=1 if volume locked */ 

number of files in file directory */ 

first block of file directory */ 

number of blocks in file directory */ 

number of alloc blocks on volume */ 

number of bytes per alloc block */ 

number of bytes to Allocate */ 

first block in volume block map */ 

next free file number */ 

number of free allocation blocks */ 



typedef struct VCB { 



struct 


QElem *qLink; 


/* 


short 


qType; 


/* 


short 


vcbFlags / 


/* 


short 


vcbSigWord; 


/* 


long 


vcbCrDate; 


/* 


long 


vcbLsBkUp; 


/* 


short 


vcbAtrb; 


/* 


short 


vcbNmFls; 


/* 


short 


vcbDirSt; 


/* 


short 


vcbBlLn; 


/* 


short 


vcbNmBlks; 


/* 


long 


vcbAlBlkSiz; 


/* 


long 


vcbClpSiz; 


/* 


short 


vcbAlBlSt ; 


/* 



next queue entry */ 

not used */ 

bit 15=1 if dirty */ 

always 0xd2d7 */ 

date volume was initialized */ 

date of last backup */ 

volume attributes */ 

number of files in directory */ 

directory's first block */ 

length of file directory */ 

number of allotiation blocks */ 

size of allocation blocks */ 

number of bytes -to Allocate */ 

first block in block map */ 
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long 


vcbNxtFNum; 


/* 


short 


vcbFreeBks; 


/* 


String (27) 


vcbVN; 


/* 


short 


vcbDrvNum; 


/* 


short 


vcbDRefNum; 


/* 


short 


vcbFSID; 


/* 


short 


vcbVRefNum; 


/* 


Ptr 


vcbMAdr ; 


/* 


Ptr 


vcbBuf Adr; 


/* 


short 


vcbMLen ; 


/* 


short 


vcbDi r Index ; 


/* 


short 


vcbDirBlk; 


/* 


} VCB; 







next unused file number */ 
number of unused blocks */ 
volume name */ 
drive number */ 
driver reference number */ 
file system identifier */ 
volume reference number */ 
location of block map */ 
location of volume buffer */ 
number of bytes in block map 
used internally */ 
used internally */ 



typedef struct DrvQEl { 

struct QElem *qLink; 

short qType; 

short dQDrive; 

short dQRefNum; 

short dQFSID; 

short dQDrvSize; 
} DrvQEl, *DrvQElPtr; 



/* next queue entry */ 

/* not used */ 

/* drive number */ 

/* drive reference number */ 

/* file system identifier */ 

/* number of logical blocks */ 



/* High-Level Routines 



*/ 



/* Accessing Volumes */ 

OSErr GetVInfo (drvNum, volName, vRefNum, f reeBytes) 

short drvNum; 

char *volName; 

short *vRefNum; 

long * f reeBytes; 
OSErr GetVol (volName, vRefNum) 

char *volName; 

short *vRefNum; 
OSErr SetVol (volName, vRefNum) 

char *volName; 

short vRefNum; 
OSErr FlushVol (volName, vRefNum) 

char *volName; 

short vRefNum; 
OSErr Unmount Vol (volName, vRefNum) 

char *volName; 

short vRefNum; 
OSErr Eject (volName,vRefNum) 

char *volName; 

short vRefNum; 



/* Changing File Contents */ 

OSErr Create (fileName,vRefNum, creator, fileType) 
char *fileName; 
short vRefNum; 
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OSType creator, fileType; 
OSErr FSOpen (f ileName, vRefNum, refNum) 

char *fileName; 

short vRefNum, *refNum; 
OSErr OpenRF (f ileName, vRefNurn, refNum) 

char *fileName; 

short vRefNum, *refNum; 
OSErr FSRead (refNum, count, buffPtr) 

short refNum; 

long * count; 

Ptr buffPtr; 
OSErr FSWrite ( refNum, count , buf f Ft r ) 

short refNum; 

long * count; 

Ptr buff Ptr; 
OSErr GetFPos (refNum, filePos) 

short refNum; 

long *filePos; 
OSErr SetFPos ( refNum, posMode,posOff) 

short refNum, posMode; 

long posOff; 
OSErr Ge t EOF (refNum, logEOF) 

short refNum; 

long * logEOF; 
OSErr SetEOF (refNum, logEOF) 

short refNum; 

long logEOF; 
OSErr Allocate (refNum, count) 

short refNum; 

long *count; 
OSErr GetVRef Num (pathRef Num, vRef Num) 

short pathRefNum; 

short *vRefNum; 
OSErr FSClose (refNum) 

short refNum; 



/* Changing Information About Files */ 

OSErr GetFInf o (f ileName, vRefNum, f ndrinf o) 

char *f ileName; 

short vRefNum; 

FInfo *fndrInfo; 
OSErr SetFInfo ( f ileName, vRef Num, f ndrinf o) 

char *f ileName; 

short vRefNum; 

FInfo *fndrInfo; 
OSErr SetFLock(f ileName, vRef Num) 

char *f ileName; 

short vRefNum; 
OSErr RstFLock (f ileName, vRef Num) 

char *f ileName; 

short vRefNum; 
OSErr Rename (oldName, vRefNum, newName) 

char * oldName; 

short vRefNum; 

char *newName; 
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OSErr FSDelete (f ileName, vRefNum) 
char *fileName; 
short vRefNum; 



/* Low-Level Routines 



void FInitQueueO 

void AddDrive (drvrRefNum,drvNum,qEl) ; 

short drvrRefNum,drvNuin; 

drvQElPtr qEL; 



/* Accessing Volumes */ 

OSErr PBMountVol (paramBlock) 

VolumeParam *paramBlock; 
OSErr PBGetVInf o (paramBlock, async) 

VolumeParam *paramBlock; 

Boolean async; 
OSErr PBGetVol (paramBlock, async) 

VolumeParam *paramBlock; 

Boolean async; 
OSErr PBSetVol (paramBlock, async) 

VolumeParam *paramBlock; 

Boolean async; 
OSErr PBFlushVol (paramBlock, async) 

VolumeParam *paramBlock; 

Boolean async; 
OSErr PBUnmountVol (paramBlock) 

VolumeParam *paramBlock; 
OSErr PBOf f Line (paramBlock) 

VolumeParam *paramBlock; 
OSErr PBE ject (paramBlock) 

VolumeParam ^paramBlock; 



/* Changing File Contents */ 

OSErr PBCreate (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 
OSErr PBOpen (paramBlock, async) 

lOParam *paramBlock; 

Boolean async; 
OSErr PBOpenRF (paramBlock, async) 

lOParam *paramBlock; 

Boolean async; 
OSErr PBRead (paramBlock, async) 

lOParam ^paramBlock; 

Boolean async; 
OSErr PBWrite (paramBlock, async) 

lOParam *paramBlock; 

Boolean async; 
OSErr PBGetFPos (paramBlock, async) 

lOParara *paramBlock; 
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Boolean async; 
OSErr PBSetFPos (paramBlock, async) 

lOParam *paraniBlock;; 

Boolean async; 
OSErr PBGetEOF (paramBlock, async) 

lOParam *paramBlock;; 

Boolean async; 
OSErr PBSetEOF (paramBlock, async) 

lOParam *parainBlock; 

Boolean async; 
OSErr PBAllocate (paramBlock, async) 

lOParam *paramBlock; 

Boolean async; 
OSErr PBFlushFile (paramBlock, async) 

lOParam *paramBlock; 

Boolean async; 
OSErr PBClose (paramBlock, async) 

lOParam *paramBlock; 

Boolean async; 



/* Changing Information About Files */ 

OSErr PBGetFInf o (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 
OSErr PBSetFInf o (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 
OSErr PBSetFLock (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 
OSErr PBRstFLock (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 
OSErr PBSetFVers (paramBlock, async) 

lOParam *paramBlock; 

Boolean async; 
OSErr PBRename (paramBlock, async) 

lOParam *paramBlock; 

Boolean async; 
OSErr PBDelete (paramBlock, async) 

FileParam *paramBlock; 

Boolean async; 



/* Accessing Queues */ 

struct QHdr *GetFSQHdr () 
struct QHdr *GetVCBQHdr ( ) 
struct QHdr *GetDrvQHdr () 



DESCRIPTION 

The File Manager controls the exchange of information between an application and 
files. 
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Warning: The low-level routines that use strings take as input and return as output 
pointers to Pascal-style strings (string length in first byte). However, the high-level 
routines use C-style strings (terminated by a null character) as input and output 
parameters. 

For more detailed information see the File Manager chapter of Inside Macintosh. 

NOTE 

An I/O completion routine cannot reliably access any globals, strings, or other 
functions outside its segment. 
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NAME 



fonts — ^Font Manager 



SYNOPSIS 






♦include 


i <types.h> 




finclude 


; <fonts.h> 




#define 


systemFont 





#define 


applFont 


1 


#define 


newYork. 


2 


#define 


geneva 


3 


#define 


monaco 


4 


#define 


Venice 


5 


#define 


london 


6 


#define 


athens 


7 


#define 


sanFran 


8 


fdefine 


toronto 


9 


#define 


Cairo 


11 


#define 


losAngeles 


12 


fdefine 


times 


20 


#define 


helvetica 


21 


♦define 


courier 


22 


fdefine 


symbol 


23 


♦define 


taliesin 


24 


♦define 


kanji 


25 


♦define 


commandMark 


'\021 


♦define 


checkMark 


'\022 


♦define 


diamondMark 


'\023 


♦define 


appleMark 


'\024 


♦define 


propFont 


0x9000 


♦define 


fixedFont 


OxBOOO 


♦define 


fontWid 


OxACBO 



typedef struct FMInput { 



short 


family; 


short 


size; 


Style 


face; 


Boolean 


needBits; 


short 


device; 


Point 


numer; 


Point 


denom; 


} FMInput; 





/* e.g. New York */ 

/* e.g. 12 Point */ 

/* e.g. bold I underline */ 

/* bits or just measurement */ 

/* always for display */ 

/* current drawing scale */ 

/* current drawing scale */ 



typedef struct FMOutput { 
short errNum; 
Handle fontHandle; 
unsigned char boldPixels; 
unsigned char italicPixels; 
unsigned char ulOffset; 
unsigned char ulShadow; 
unsigned char ulThick; 
unsigned char shadowPixels; 
char extra; 

unsigned char ascent; 



/* not used */ 

/* Handle to font */ 

/* pixels of horizontal smear */ 

/* pixels of horizontal shear */ 

/* pixels below baseline */ 

/* pixels in halo */ 

/* thickness of underline */ 

/* pixels to shadow (0 .. 3) */ 

/* extra white pixels/char */ 

/* ascent */ 
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} 



unsigned char descent; 
unsigned char widMax; 
char leading; 

char unused; 

Point nuitier; 
Point denom; 
FMOutput, *FMOutPtr; 



/* descent */ 

/* maximum character width */ 

/* leading between lines */ 

/* not used */ 

/* current drawing scale */ 

/* current drawing scale */ 



typedef struct 

short 

short 

short 

short 

short 

short 

short 

short 

short 

short 

short 

short 

short 

/* 

short 

short 

short 

*/ 
} FontRec; 



FontRec { 
fontType; 
f irstChar; 
lastChar; 
widMax; 
kernMax; 
nDe scent; 
fRectWidth; 
fRectHeight; 
owTLoc; 
ascent; 
descent; 
leading; 
rowWords; 



/* font type */ 

/* ASCII code of first character */ 

/* ASCII code of last character */ 

/* maximum character width */ 

/* negative of maximum character kern */ 

/* negative of descent */ 

/* width of font rectangle */ 

/* height of font rectangle */ 

/* offset to offset/width table */ 

/* ascent */ 

/* descent */ 

/* leading */ 



bitlmage [ (rowWords-1) +1] [ (fRectHeight-1) +1] ; 
locTable [ (lastChar+2-f irstChar) +1] ; 
owTable [ (lastChar+2-f irstChar) +1] ; 



pascal void InitFontsO 

void GetFontName (f ontNum, theName) 

short fontNum; 

char *theName; 
void GetFNum ( f ontName , theNum) 

char *f ontName; 

short * theNum; 
pascal Boolean RealFont (fontNum, size) 

short fontNum; 

short size; 
pascal void SetFontLock (lockFlag) 

Boolean lockFlag; 
pascal FMOutPtr SwapFont (inRec) 

FMInput * inRec; 



DESCRIPTION 

The Font Manager supports the character fonts used to draw text with QuickDraw. 
For more detailed information see the Font Manager chapter of Inside 
Macintosh. 
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NAME 



memory — ^Memory Manager 



SYNOPSIS 

#include <types.h> 
#include <memory.h> 

#define maxSize 0x800000 

/* Result Codes */ 

#define memFullErr (-108) 
#define memLockedErr (-117) 
fdefine memPurErr (-112) 
#define memWZErr (-111) 
#define nilHandleErr (-109) 
#define noErr 

typedef long Size; 

typedef struct Zone { 



Ptr 


bkLim; 


Ptr 


purgePtr; 


Ptr 


hFstFree; 


long 


zcbFree; 


ProcPtr 


gzProc; 


short 


moreMast; 


short 


flags; 


short 


cntRel; 


short 


maxRel; 


short 


cntNRel; 


short 


maxNRel; 


short 


cnt Empty; 


short 


cntHandles; 


long 


minCBFree; 


ProcPtr 


purgeProc; 


Ptr 


sparePtr; 


Ptr 


allocPtr; 


short 


heapData; 


} Zone, *TH 


z; 



/* maximum block size */ 



/* not enough room in zone */ 

/* block is locked */ 

/* attempt to purge a locked block */ 

/* attempt to operate on a free block */ 

/* nil master pointer */ 

/* no error */ 



/* limit pointer */ 

/* used internally */ 

/* first free master pointer */ 

/* number of free bytes */ 

/* grow zone function */ 

/* master pointers to allocate */ 

/* used internally */ 

/* relocatable blocks */ 

/* maximum cntRel value */ 

/* nonrelocatable blocks */ 

/* maximum maxRel value */ 

/* empty master pointers */ 

/* total master pointers */ 

/* minimum zcbFree value */ 

/* purge warning procedure */ 

/* used internally */ 

/* used internally */ 

/* first usable byte in zone */ 



/* Initialization and Allocation */ 

void InitApplZone 

void SetApplBase (startPtr) 

Ptr StartPtr; 
void Init Zone (pGrowProc, cMoreMasters , limitPt r , startPtr) 

ProcPtr pGrowProc; 

short cMoreMasters; 

Ptr limitPtr, StartPtr; 
void SetApplLimit (zoneLimit) 

Ptr zoneLimit; 
Ptr GetApplLimit ( ) 
void MaxApplZone 
void MoreMasters ( ) 
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/* Heap Zone Access */ 

THz GetZoneO 
void SetZone(hz) 

THz hz; 
THz SystemZone ( ) 
THz ApplicZoneO 



/* Allocating and Releasing Relocatable Blocks */ 

Handle NewHandle (logicalSize) 

Size logicalSize; 
void DisposHandle (h) 

Handle h; 
Size GetHandleSize (h) 

Handle h; 
void SetHandleSize (h,newSize) 

Handle h; 

Size newSize; 
THz HandleZone (h) 

Handle h; 
Handle RecoverHandle (p) 

Ptr p; 
void ReallocHandle <h, logicalSize) 

Handle h; 

Size logicalSize; 



/* Allocating and Releasing Nonrelocatable Blocks */ 

Ptr NewPtr (logicalSize) 

Size logicalSize; 
void DisposPtr (p) 

Ptr p; 
Size GetPtrSize(p) 

Ptr p; 
void SetPtrSize (p,newSize) 

Ptr p; 

Size newSize; 
THz PtrZone (p) 

Ptr p; 



/* Freeing Space in the Heap */ 

long FreeMemO 
Size MaxMem(grow) 

Size *grow; 
Size CoinpactMem(cbNeeded) 

Size cbNeeded; 
void ResrvMem (cbNeeded) 

Size cbNeeded; 
void PurgeMem (cbNeeded) 

Size cbNeeded; 
void EmptyHandle (h) 
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Handle h; 



/* Properties of Relocatable Blocks */ 

void HLock(h) 

Handle h; 
void HUnlock(h) 

Handle h; 
void HPurge (h) 

Handle h; 
void HNoPurge (h) 

Handle h; 



/* Grow Zone Operations */ 

void SetGrowZone (growZone) 

ProcPtr growZone; 
Boolean GZCriticalO 
Handle GZSaveHndO 



/* Miscellaneous Routines */ 

BlockMove (sourcePtr,destPtr,byteCount) 

Ptr sourcePtr, destPtr; 

long byteCount; 
Ptr TopMemO 
void MoveHHi(h) 

Handle h; 
OSErr MemErrorO 



USER ROUTINES 

pascal Size MyGrowZone (cbNeeded) 
Size cbNeeded; 

DESCRIPTION 

The Memory Manager provides dynamic allocation of both relocatable and 
nonrelocatable memory space within the system and application heaps. 

For more detailed information see the Memory Manager chapter of Inside 
Macintosh, 
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NAME 

menus — ^Menu Manager 

SYNOPSIS 

# include <types.h> 
#include <menus.h> 

/* Special Characters */ 

#define noMark '\0' 

/* Messages to Menu Definition Functions */ 

tdefine mDrawMsg 

#define mChooseMsg 1 
tdefine mSizeMsg 2 

/* Resource ID of Standard Menu Definition Procedure */ 

tdefine textMenuProc 



typedef struct Menulnfo { 
short menu ID ; 
short menuWidth; 
short menuHeight; 
ProcHandle menuP roc- 
long enableFlags; 
Str255 menuData; 

} Menulnfo, *MenuPtr, **MenuHandle; 



/* Initialization and Allocation */ 

pascal void InitMenusO 

MenuHandle NewMenu (inenuID,menuTitle) 

short menu ID; 

char *menuTitle; 
pascal MenuHandle GetMenu( resource ID) 

short resourcelD; 
pascal void DisposeMenu (theMenu) 

MenuHandle theMenu; 
void AppendMenu (theMenu, data) 

MenuHandle theMenu; 

char *data; 
pascal void AddResMenu (theMenu, theType) 

MenuHandle theMenu; 

ResType theType; 
pascal void InsertResMenu (theMenu, theType, afterltem) 

MenuHandle theMenu; 

ResType theType; 

short afterltem; 



/* Forming the Menu Bar */ 

pascal void InsertMenu (theMenu, beforelD) 
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MenuHandle theMenu; 

short beforelD; 
pascal void DrawMenuBar () 
pascal void DeleteMenu (menuID) 

short menu ID; 
pascal void ClearMenuBar () 
pascal Handle GetNewMBar (menuBarlD) 

short menuBarlD; 
pascal Handle GetMenuBarO 
pascal void SetMenuBar (menuList) 

Handle menuList; 



/* Choosing From a Menu */ 

long MenuSelect (startPt) 

Point *startPt; 
pascal long MenuKey(ch) 

short ch; 
pascal void HiliteMenu (menuID) 

short menuID; 



/* Controlling Items' Appearance */ 

void SetItem(theMenu, item, itemString) 

MenuHandle theMenu; 

short item; 

char *itemString; 
void Get Item (theMenu, item, itemString) 

MenuHandle theMenu; 

short item; 

char ^itemString; 
pascal void Disableltem (theMenu, item) 

MenuHandle theMenu; 

short item; 
pascal void Enableltem (theMenu, item) 

MenuHandle theMenu; 

short item; 
pascal void Checkltem (theMenu, item, checked) 

MenuHandle theMenu; 

short item; 

Boolean checked; 
pascal void SetltemMark (theMenu, item, markChar) 

MenuHandle theMenu; 

short item; 

short markChar; 
pascal void GetltemMark (menu, item, markChar) 

MenuHandle menu; 

short item; 

short *markChar; 
pascal void Setltemlcon (theMenu, item, iconNum) 

MenuHandle theMenu; 

short item; 

short iconNum; 
pascal void Getltemlcon (theMenu, item, iconNum) 

MenuHandle theMenu; 
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short item; 

short *iconNum; 
pascal void SetltemStyle (theMenu, item^chStyle) 

MenuHandle theMenu; 

short item; 

Style chStyle; 
pascal void GetltemStyle (menu, item, chStyle) 

MenuHandle menu; 

short item; 

Style *chStyle; 

/* Miscellaneous Utilities */ 

pascal void CalcMenuSize (theMenu) 

MenuHandle theMenu; 
pascal short CountMItems (theMenu) 

MenuHandle theMenu; 
pascal MenuHandle GetMHandle (menuID) 

short menuID; 
pascal void FlashMenuBar (menuID) 

short menuID; 
pascal void SetMenuFlash (count) 

short count; 



USER ROUTINES 

pascal void MyMenu (message, theMenu, menuRect,hitPt,whichItem) 
short message; 
MenuHandle theMenu; 
Rect *menuRect ; 
Point hitPt; 
short *whichltem; 

DESCRIPTION 

The Menu Manager provides routines for creating and using menus. 

Warning: The names of desk accessories start with a null byte. The output 
parameter from GetMenuItem will return a string that begins with a null byte when 
a desk accessory is selected from the Apple menu. Opei5)eskAcc skips over the 
null byte when interpreting its parameter. 

For more detailed information see the Menu Manager chapter of Inside 
Macintosh. 
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NAME 

osevents — Operating System Event Manager 

SYNOPSIS 

#include <types.h> 
finclude <osevents.h> 

typedef struct EvQEl { 
struct QElem *qLink; 
short qType; 



short 


evtQWhat ; 


long 


evtQMessage; 


long 


evtQWhen; 


Point 


evtQWhere; 


short 


evtQModif iers ; 


} EvQEl; 





/* Setting the System Event Mask */ 

void SetEventMask(theMask) 
short theMask; 



/* Posting and Removing Events */ 

OSErr PostEvent ( event Code, eventMsg) 

short eventCode; 

long eventMsg; 
void FlushEvents (eventMask, stopMask) 

short eventMask; 

short stopMask; 



/* Accessing Events */ 

Boolean GetOSEvent (eventMask, theEvent) 

short eventMask; 

struct EventRecord *theEvent; 
Boolean OSEventAvail (eventMask, theEvent) 

short eventMask; 

struct EventRecord *theEvent; 



/* Directly Accessing the Event Queue */ 
struct QHdr *GetEvQHdr() 

DESCRIPTION 

The Operating System Event Manager provides a low-level interface to the 
Macintosh keyboard, keypad, and mouse. 

For more detailed information see the Operating System Event Manager chapter of 
Inside Macintosh, 
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NAME 



osutils — Operating System Utilities 



SYNOPSIS 

#include <types.h> 
#include <osutils.h> 



#define noErr 

#define qErr (-1) 

#define clkRdErr (-85) 

#define clkWrErr (-8 6) 

#define prWrErr (-87) 

#define prInitErr (-88) 

#define memFullErr (-108) 

fdefine nilHandleErr (-109) 

#define memWZErr (-111) 



/* no error */ 

/* element not in specified queue */ 
unable to read clock */ 
time written did not verify */ 
parameter RAM written did not verify */ 
validity status is not 0xa8 */ 

/* not enough room in heap */ 

/* nil master pointer */ 

/* attempt to operate on a free block */ 



/* 
/* 



/* Serial Port configuration constants for config field of SysParmType */ 



#def ine 
#define 
#define 



useFree 

useATalk 

useAsync 



/* use undefined */ 

1 /* AppleTalk */ 

2 /* Async */ 



/* Machine type returned by "Environs" routine */ 



#define macXLMachine 
#define macMachine 

/* typedef long OSType; 
/* typedef short OSErr; 



/* Macintosh XL (a.k.a. Lisa) */ 

1 /* Macintosh */ 

appears in file TYPES */ 
appears in file TYPES */ 



typedef struct SysParmType { 
char valid; 
char aTalkA; 
char aTalkB; 
char config; 



short 

short 

long 

short 

short 



port A; 
portB; 
alarm; 
font ; 
kbdPrint; 



short volClik; 
short misc; 
} SysParmType, *SysPPtr; 



/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 



validity status */ 

AppleTalk node # hint for port A */ 
AppleTalk node # hint for port B */ 
AppleTalk serial port configuration */ 

port A = bits 4-7, B = bits 0-3 */ 
modem port configuration */ 
printer port configuration */ 
alarm setting */ 

default application font number - 1 */ 
auto-key threshold and rate, printer */ 

connection */ 
speaker volume, double-click and */ 

caret-blink times */ 
mouse scaling, system startup disk, */ 

menu blink */ 



typedef struct QElem { 

struct QElem *qLink; 
short qType; 

short qData[0]; 

} QElem, *QElemPtr; 



/* next queue entry */ 

/* queue type */ 

/* queue type specific data */ 
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typedef struct QHdr { 
short qFlags; 
QElemPtr qHead; 
QElemPtr qTail; 

} QHdr, *QHdrPtr; 



/* queue flags */ 

/* first queue entry */ 

/* last queue entry */ 



typedef enum { 
dummyType, 
vType, 
ioQType, 
drvQType , 
evType, 
fsQType 

} QTypes; 



/* vertical retrace queue type */ 

/* file I/O or driver I/O type */ 

/* drive queue type */ 

/* event queue type */ 

/* volume-control-block queue type 



typedef struct DateTimeRec { 



short 
short 
short 
short 
short 
short 
short 
} DateTimeRec; 



year; 

month ; 

day; 

hour; 

minute; 

second; 

dayOfWeek; 



/* four-digit year */ 

/* 1 to 12 for January to December */ 

/* 1 to 31 */ 

/* to 23 */ 

/* to 59 */ 

to 59 */ 

1 to 7 for Sunday to Saturday */ 



/* 
/* 



/* Pointer and Handle Manipulation */ 

OSErr HandToHand(theHndl) 

Handle *theHndl; 
OSErr PtrToHand(srcPtr,dstHndl, size) 

Ptr srcPtr; 

Handle *dstHndl; 

long size; 
OSErr PtrToXHand(srcPtr,dstHndl, size) 

Ptr srcPtr; 

Handle dstHndl; 

long size; 
OSErr HandAndHand(aHndl,bHndl) 

Handle aHndl,bHndl; 
OSErr PtrAndHand(pntr,hndl,size) 

Ptr pntr; 

Handle hndl; 

long size; 



/* String Comparison */ 

Boolean EqualString(aStr,bStr,caseSens,diacSens) 

char *aStr,*bStr; 

Boolean caseSens,diacSens; 
void UprString(theString,diacSens) 

char *theString; 
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Boolean marks; 



/* Date and Time Operations */ 

OSErr ReadDateTime (sees) 

long *secs; 
void GetDateTime (sees) 

long *sees; 
OSErr SetDateTime (sees) 

long sees; 
void Date2Secs (date, sees) 

DateTimeRee *date; 

long *sees; 
void Sees2Date (sees, date) 

long sees; 

DateTimeRee *date; 
void GetTime (date) 

DateTimeRee *date; 
void SetTime (date) 

DateTimeRee *date; 



/* Parameter RAM Operations */ 

OSErr InitUtilO 
SysPPtr GetSysPPtrO 
OSErr WriteParamO 



/* Queue Manipulation */ 

void Enqueue (qElement,theQueue) 

QElemPtr qElement; 

QHdrPtr theQueue; 
OSErr Dequeue (qElement, theQueue) 

QElemPtr qElement; 

QHdrPtr theQueue; 



/* Dispatch Table Utilities */ 

void SetTrapAddress (trapAddr, trapNum) 

long trapAddr; 

short trapNum; 
long GetTrapAddress (trapNum) 

short trapNum; 



/* Miscellaneous Utilities */ 

void Delay (numTicks,finalTicks) 
long numTicks, *finalTieks; 

pascal void SysBeep (duration) 
short duration; 

void Environs (rom, machine) 
short *rom, *machine; 
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void Restart () 

DESCRIPTION 

The Operating System Utilities are a set of routines and data types in the Operating 
System that perform generally useful operations such as manipulating pointers and 
handles, comparing strings, and reading the date and time. 

For more detailed information see the Operating System Utilities chapter of Inside 
Macintosh, 
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NAME 

packages — 

Package Manager, Disk Initialization, Standard File Package, International Utilities, 
Binary-Decimal Conversion 

SYNOPSIS 

♦include <types.h> 
#include <pack;ages .h> 



/* Package Manager 

/* Resource IDs for packages */ 



*/ 



#define 
#define 
tdefine 
idefine 
#define 
fdefine 



dsklnit 

stdFile 

flPoint 

trFunc 

intUtil 

bdConv 



/* Disk Initializaton */ 

/* Standard File */ 

/* Floating-Point Arithmetic */ 

/* Transcendental Functions */ 

/* International Utilities */ 

/* Binary/Decimal Conversion */ 



pascal void InitAllPacks () 
pascal void InitPack (packID) 
short packID; 



/* Disk Initialization Package 



void DILoadO 

void DIUnLoadO 

short DIBadMount (where, evtMessage) 

Point where; 

long evtMessage; 
OSErr DIFormat (drvNum) 

short drvNum; 
OSErr D I Verify (drvNum) 

short drvNum; 
OSErr DIZero (drvNum, volName) 

short drvNum; 

char *volName; 



/* Standard File Package - 
fdefine putDlgID (-3999) 



#define putSave 
#define putCancel 
#define putEject 
tdefine putDrive 
#define putName 



fdefine get Open 
#define getCancel 
#define getEject 



#define getDlgID (-4000) 



/* SFPutFile dialog template ID */ 

/* Save button */ 

/* Cancel button */ 

/* Eject button */ 

/* Drive button */ 

/* editTExt item for file name */ 

/* SFGetFile dialog template ID */ 

/* Open button */ 
/* Cancel button */ 
/* Eject button */ 
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/* Drive button */ 

/* userltem for file name list */ 

/* userltem for scroll bar */ 



/* FALSE if ignore command */ 

/* not used */ 

file type or not used */ 
volume reference number */ 

/* file's version number */ 

/* file name */ 



/* 
/* 



fdefine getDrive 6 
#def ine getNmList 7 
#define getScroll 8 

typedef struct SFReply { 

Boolean good; 

Boolean copy; 

OSType fType; 

short vRefNum; 

short version; 

String (63) fName; 
} SFReply; 

typedef OSType SFTypeList [4] ; 

void SFPUtFile (where, prompt, origName,dlgHook, reply) 

Point *where; 

char *prompt; 

char *origName; 

ProcPtr dlgHook; 

SFReply * reply; 
void SFPPutFile ( where, prompt, origName, dlgHook, reply, dlglD, f ilterProc) 

Point *where; 

char *prompt; 

char *origName; 

ProcPtr dlgHook; 

SFReply * reply; 

short dlglD; 

ProcPtr f ilterProc; 
void SFGetFile (where, prompt, fileFilter,numTypes,typeList, dlgHook, reply) 

Point *where; 

char *prompt; 

ProcPtr fileFilter; 

short numTypes; 

SFTypeList typeList; 

ProcPtr dlgHook; 

SFReply * reply; 
void SFPGetFile (where, prompt, fileFilter, numTypes, typeList, dlgHook, reply, 
dlglD, f ilterProc) 

Point *where; 

char *prompt; 

ProcPtr fileFilter; 

short numTypes; 

SFTypeList typeList; 

ProcPtr dlgHook; 

SFReply * reply; 

short dlglD; 

ProcPtr filterProc; 



/* International Utilities Package 
/* Masks for currency format */ 



#define currSymLead 16 
#define currNegSym 32 
#define currTrailingZ 64 



/* set if currency symbol leads */ 
/* set if minus sign for negative */ 
/* set if trailing decimal zeroes */ 
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#define currLeadingZ 128 /* set if leading integer zeroes */ 
/* Order of short date elements */ 



#define mdy 
#define dmy 
♦define ymd 



/* month day year */ 

1 /* day month year */ 

2 /* year month day */ 



/* Masks for short date format */ 



#define dayLdingZ 32 

#define mntLdingZ 64 

#define century 12 8 

/* Masks for time format */ 

#define secLeadingZ 32 

tdefine mihLeadingZ 64 

#define hrLeadingZ 12 8 



/* set if leading zero for day */ 
/* set if leading zero for month */ 
/* set if century included */ 



/* set if leading zero for seconds */ 
/* set if leading zero for minutes */ 
/* set if leading zero for hours */ 



/* Country Codes — high-order byte of version information */ 



tdefine 


verUS 





♦define 


verFrance 


1 


♦define 


verBritain 


2 


♦define 


verGermany 


3 


♦define 


verltaly 


4 


♦define 


verNet her lands 


5 


♦define 


verBelgiumLux 


6 


♦define 


ver Sweden 


7 


♦define 


verSpain 


8 


♦define 


verDenmark 


9 


♦define 


verPortugal 


10 


♦define 


verFrCanada 


11 


♦define 


verNorway 


12 


♦define 


verlsrael 


13 


♦define 


ver Japan 


14 


♦define 


verAustralia 


15 


♦define 


ver Arabia 


16 


♦define 


verFinland 


17 


♦define 


verFrSwiss 


18 


♦define 


verGrSwiss 


19 


♦define 


verGreece 


20 


♦define 


verlceland 


21 


♦define 


verMalta 


22 


♦define 


ver Cyprus 


23 


♦define 


verTurkey 


24 


♦define 


verYugoslavia 


25 



typedef struct IntlORec { 
char decimalPt; 
char thousSep; 
char listSep; 
char currSyml; 
char currSym2; 
char currSym3; 
unsigned char currFmt; 



/* decimal point character */ 

/* thousands separator */ 

/* list separator */ 

/* currency symbols (3 bytes long) */ 



/* currency format */ 
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unsigned char dateOrder; 

unsigned char shrtDateFmt; 

char dateSep; 

unsigned char timeCycle; 

unsigned char timeFmt; 

char mornStr[4]; 

char eveStr[4]; 

char timeSep; 

char timelSuff; 

char time2Suff; 

char timeSSuff; 

char time4Suff; 

char timeSSuff; 

char time6Suff; 

char timeVSuff; 

char timeSSuff; 

unsigned char metricSys; 

short intlOVers; 



/* 
/* 
/* 
/* 
/* 
/* 
/* 



short date order - dmy, ymd or mdy 

short date format */ 

date separator */ 

if 24-hour cycle, 255 if 1- hour 

time format */ 

trailing string for first 12 hours 

trailing stringfor last 12 hours */ 
/* time separator */ 
/* trailing string for 24-hour cycle */ 



/ 






/* 255 for metric, if not */ 

/* version information - country, vers */ 



} IntlORec, *IntlOPtr, **IntlOHndl; 



typedef struct IntllRec { 
String (15) days [7]; 
String (15) months [12]; 
unsigned char suppressDay; 
unsigned char IngDateFmt; 
unsigned char dayLeadingO; 
unsigned char abbrLen; 
char st0[4] 



char stl[4] 




char st2[4] , 




char st3[4] , 




char st4 [4] , 




short intllVers; 


short locall 


^tn[0] 



/* day names */ 

/* month names */ 

/* for day name, 255 for none */ 

/* order of long date elements */ 

/* 255 for leading in day number */ 

/* length for abbreaviating names */ 

/* date punctuation */ 



/* version information */ 
/* routine for string conparison */ 
} IntllRec, *IntllPtr, **IntllHndl; 

typedef enum {shortDate, longDate,abbrevDate} DateForm; 

void IUDateString(dateTime, form, result) 

long dateTime; 

DateForm form; 

char *result; 
void lUDatePString (dateTime, form, result, intlParam) 

long dateTime; 

DateForm form; 

char *result; 

Handle intlParam; 
void IUTimeString(dateTime,wantSeconds, result) 

long dateTime; 

Boolean wantSeconds; 

char ^result; 
void lUTimePString (dateTime, wantSeconds, result, intlParam) 

long dateTime; 

Boolean wantSeconds; 

char ^result; 

Handle intlParam; 
Boolean lUMetricO 



Page 112 



PACKAGES Macintosh Interface Libraries PACKAGES 



Handle lUGetlntl (thelD) 

short thelD; 
void IUSetIntl(refNum,theID,intlParam) 

short refNum; 

short the ID; 

Handle intlParam; 
short IUCompString(aStr,bStr) 

char *aStr; 

char *bStr; 
short IUMagString(aPtr,bPtr,aLen,bLen) 

Ptr aPtr,bPtr; 

short aLen,bLen; 
short IUEqualString(aStr,bStr) 

char *aStr; 

char *bStr; 
short lUMaglDSt ring (aPt r , bPt r , aLen, bLen) 

Ptr aPtr,bPtr; 

short aLen,bLen; 



/* Binary-Decimal Conversion Package 

void StringToNum (theString, theNum) 

char *theString; 

long * theNum; 
void NumToString (theNum, theString) 

long theNum; 

char *theString; 



USER ROUTINES 

/* Standard File Package 



short MyDlg(item, theDialog) 
short item; 
DialogPtr theDialog; 

Boolean MyFileFilter (paramBlock) 
ParmBlkPtr paramBlock; 

DESCRIPTION 

The Package Manager provides for the initialization of packages. 

For more detailed information see the following chapters of Inside Macintosh: 
Package Manager, Disk Initialization Package, Standard File Package, International 
Utilities Package, Binary-Decimal Conversion Package. 
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NAME 



printing — ^Printing Manager 



SYNOPSIS 

#include <types.h> 
finclude <quickdraw.h> 
♦include <printing.h> 



/* Printing Methods */ 

#define bDraftLoop 
fdefine bSpoolLoop 



/* draft printing */ 

1 /* spooling */ 



/* Printer specification in prStl field of print record */ 



fdefine bDevCItoh 
#define bDevLaser 



1 /* ImageWriter printer */ 
3 /* LaserWriter printer */ 



/* Maximum number of pages in a spool file */ 



#define iPFMaxPgs 
#define iPrPgFract 

/* Result codes */ 



fdefine 


noErr 





fdefine 


iPrSavPFil 


(-1) 


fdefine 


ilOAbort 


(-27) 


fdefine 


iMemFullErr 


(-108) 


fdefine 


iPr Abort 


128 



128 /* max pages in a spool file */ 
120 /* paper units per inch */ 



/* no error */ 

/* saving spool file */ 

/* I/O abort error */ 

/* not enough room in heap zone */ 

/* application or user requested abort */ 



/* Printer Driver Control Call Parameters */ 



fdefine iPrDevCtl 7 

fdefine IPrReset 0x00010000 

fdefine IPrLineFeed 0x00030000 

fdefine IPrLFSixth 0x0003FFFF 

fdefine iPrPageEnd 0x00020000 

fdefine iPrBitsCtl 4 

fdefine IScreenBits 

fdefine IPaintBits 1 

fdefine iPrlOCtl 5 



/* 
/* 



device control */ 

reset printer */ 
/* start new line */ 
/* standard 1/6" line feed */ 

start new page */ 

bit map printing */ 
/* configurable */ 
/* 72 X 72 dots */ 
/* text streaming */ 



/* 



/* Printing Resources */ 

fdefine sPrDrvr 
fdefine iPrDrvrRef 



".Print" /* Printer Driver resource name */ 

(-3) /* Printer Driver reference number */ 



/* Type definitions */ 

typedef Rect *TPRect; 

typedef struct TPrPort { 
Graf Port gPort; 



/* graph port to draw in */ 
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QDProcs gProcs; /* pointers to drawing routines */ 

long IGParaml; /* internal */ 

long lGParam2; /* internal */ 

long IGParamS; /* internal */ 

long lGParain4; /* internal */ 

Boolean fOurPtr; /* internal */ 

Boolean fOurBits; /* internal */ 

} TPrPort, *TPPrPort; 



typedef struct TPrlnfo { 



short 
short 
short 
Rect 
} TPrlnfo; 



iDev; /* printer information */ 

iVRes; /* printer vertical resolution */ 

iHRes; /* printer horizontal resolution */ 

rPage; /* page rectangle */ 



typedef enum {feedCut, f eedFanf old, feedMechCut, feedOther } TFeed; 



typedef struct TPrStl { 



short 


wDev; 


short 


iPageV; 


short 


iPageH; 


char 


bPort; 


TFeed 


feed; 


TPrStl; 





/* high byte specifies device */ 

/* paper height */ 

/* paper width */ 

/* printer or modem port - ignored */ 

/* paper type */ 



typedef enum {scanTB, scanBT, scanLR, scanRL} TScan; 



typedef struct TPrXInfo { 



short 


iRowBytes; 


short 


iBandV; 


short 


iBandH ; 


short 


iDevBytes; 


short 


iBands ; 


char 


bPat Scale; 


char 


bUlThick; 


char 


bUlOffset; 


char 


bUlShadow; 


TScan 


scan; 


char 


bXInfoX; 


TPrXInfo; 





/* bytes per row */ 

/* vertical dots */ 

/* horizontal dots */ 

/* size of bit image */ 

/* bands per page */ 

/* used by QuickDraw */ 

/* underline thickness ' 

/* underline offset */ 

/* underline descender ■ 

/* scan direction */ 

/* not used */ 



typedef struct TPrJob { 

short iFstPage; 

short iLstPage; 

short iCopies; 

char bJDocLoop; 

Boolean fFromUsr; 

ProcPtr pIdleProc; 

StringPtr pFileName; 

short iFileVol; 

char bFileVers; 

char bJobX; 
} TPrJob; 



/* first page to print */ 

/* last page to print */ 

/* number of copies */ 

/* printing method */ 

/* true if called from application */ 

/* background procedure */ 

/* spool file name */ ??? 

/* volume reference number */ 

/* version number of spool file */ 

/* not used */ 



typedef struct TPrint { 

short iPrVersion; /* Printing Manager version */ 
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TPrlnfo prinfo; /* printing information 

Rect rPaper; /* paper rectangle */ 

TPrStl prStl; /* style information */ 

TPrlnfo prInfoPT; /* copy of prinfo */ 

TPrXInfo prXInfo; /* band information */ 

TPrJob prJob; /* job information */ 

short printX[19] /* internal */ 
} TPrint, *TPPrint, **THPrint; 



typedef struct TPrStatus { 



short 
short 
short 
short 
short 
short 
Boolean 
Boolean 
THPrint 
TPPrPort pPrPort; 
PicHandle hPic; 
} TPrStatus; 



iTotPages; 

iCurPage; 

iTotCopies; 

iCurCopy; 

iTotBands ; 

iCurBand; 

fPgDirty; 

f Imaging ; 

hPrint; 



/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 
/* 



total number of pages */ 

page being printed */ 

number of copies */ 

copy begin printed */ 

bands per page */ 

band being printed */ 

true if started printing page */ 

true if imaging */ 

print record */ 

printing port */ 

internal */ 



/* Initialization and Termination */ 

pascal void PrOpenO 
pascal void PrCloseO 

/* Print Records and Dialogs */ 

pascal void PrintDefault (hPrint) 

THPrint hPrint; 
pascal Boolean PrValidate (hPrint) 

THPrint hPrint; 
pascal Boolean PrStlDialog (hPrint) 

THPrint hPrint; 
pascal Boolean PrJobDialog (hPrint) 

THPrint hPrint; 
pascal void PrJobMerge (hPrintSrc,hPrintDst) 

THPrint hPrintSrc,hPrintDst; 

/* Document Printing */ 

pascal TPPrPort PrOpenDoc (hPrint, pPrPort,pIOBuf) 

THPrint hPrint; 

TPPrPort pPrPort; 

Ptr pIOBuf; 
pascal void PrCloseDoc (pPrPort) 

TPPrPort pPrPort; 
pascal void PrOpenPage (pPrPort,pPageFrame) 

TPPrPort pPrPort; 

TPRect pPageFrame; 
pascal void PrClosePage (pPrPort) 

TPPrPort pPrPort; 

/* Spool Printing */ 
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pascal void PrPicFile (hPrint,pPrPort,pIOBuf ,pDevBuf ,prStatus) 
THPrint hPrint; 
TPPrPort pPrPort; 
Ptr pIOBuf ,pDevBuf ; 
TPrStatus *prStatus; 

/* Handling Errors */ 

pascal short PrErrorO 
pascal void PrSetError (iErr) 
short iErr; 

/* Low Level Driver Access */ 

pascal void PrDrvrOpenO 

pascal void PrDrvrClose () 

pascal void PrCtlCall (iWhichCtl, IParaml, lParam2, IParamS) 

short iWhichCtl; 

long IParaml, lParam2, IParamS; 
pascal Handle PrDrvrDCEO 
pascal short PrDrvrVersO 



DESCRIPTION 

The Printing Manager supports printing on a variety of devices. 

For more detailed information see the Printing Manager chapter of Inside 
Macintosh. 



NOTE 



The current Pascal implementation has additional constants and data types that 
aren't documented in Inside Macintosh because they're not generally used. 
This interface follows Inside Macintosh . 

Programs that call the high-level printing routines must be linked with object file 
prlink.obj. Programs that call the low-level driver routines must link witii 
prscreen.obj. Linking with both files yields duplicate definitions. Therefore a 
program can't call both the high-level routines and the driver routines. 
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NAME 



quickdraw — QuickDraw 



SYNOPSIS 

#include <types.h> 
#include <quic)cdraw.h> 

/* 16 Transfer Modes */ 



#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 



srcCopy 

srcOr 

srcXor 

srcBic 

not SrcCopy 

notSrcOr 

notSrcXor 

notSrcBic 

patCopy 

patOr 

patXor 

patBic 

notPatCopy 

notPatOr 

notPatXor 

notPatBic 





1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 



/* QuickDraw Color Separation Constants */ 



#define 
#define 
#define 
fdefine 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 
#define 



normalBit 

inverseBit 

redBit 

greenBit 

blueBit 

cyanBit 

magentaBit 

yellowBit 

blackBit 

blackColor 

whiteColor 

redColor 

greenColor 

blueColor 

cyanColor 

magentaColor 

yellowColor 



/* Picture Comments */ 

#define picLParen 
#define picRParen 





1 

4 

3 

2 

8 

7 

6 

5 

33 

30 

205 

341 

409 

273 

137 

69 



/* Type Style Constants */ 

#def ine normal 0x00 

#define bold 0x01 

#define italic 0x02 

#define underline 0x04 



/* RGB Additive Mapping */ 



/* CMYBk Subtr active Mapping */ 



/* Colors Expressed in these Mappings */ 
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#def ine 


outline 


0x08 


#define 


shadow 


0x10 


#def ine 


condense 


0x20 


#def ine 


expand 


0x40 


/* Types 


*/ 





typedef unsigned char Pattern [8]; 

typedef short Bitsl6[16]; 

typedef enum {frame, paint /erase, invert, fill} Graf Verb; 

/* typedef s Style, Point, and Rect appear in file TYPES */ 

typedef struct Font Info { 

short ascent; 

short descent; 

short widMax; 

short leading; 
} Font Info; 

typedef struct BitMap { 

Ptr baseAddr; 

short rowBytes; 

Rect bounds; 
} BitMap; 

typedef struct Cursor { 

Bitsl6 data; 

Bitsl6 mask; 

Point hot Spot; 
} Cursor; 

typedef struct PenState { 

Point pnLoc; 

Point pnSize; 

short pnMode; 

Pattern pnPat; 
} PenState; 

typedef struct Region { 

short rgnSize; 

Rect rgnBBox; 

short rgnData [ ] ; 
} Region, *RgnPtr, **RgnHandle; 

typedef struct Picture { 

short picSize; 

Rect picFrame; 

short picData [ ] ; 
} Picture, *PicPtr, **PicHandle; 

typedef struct Polygon { 

short polySize; 

Rect polyBBox; 

Point polyPoints [0] ; 
} Polygon, *PolyPtr, **PolyHandle; 
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typedef struct QDProcs { 


ProcPtr 


textProc; 


ProcPtr 


lineProc; 


ProcPtr 


rectProc; 


ProcPtr 


rRectProc; 


ProcPtr 


ovalProc; 


ProcPtr 


arcProc; 


ProcPtr 


polyProc; 


ProcPtr 


rgnProc; 


ProcPtr 


bitsProc; 


ProcPtr 


comment P roc ; 


ProcPtr 


txMea sP roc- 


ProcPtr 


get PicP roc- 


ProcPtr 


put PicP roc; 


} QDProcs, 


*QDProcsPtr; 


typedef struct GrafPort { 


short 


device; 


BitMap 


portBits; 


Rect 


portRect; 


RgnHandle visRgn; 


RgnHandle clipRgn; 


Pattern 


bkPat; 


Pattern 


fillPat; 


Point 


pnLoc ; 


Point 


pnSize; 


short 


pnMode ; 


Pattern 


pnPat; 


short 


pnVis; 


short 


txFont ; 


Style 


txFace; 


short 


txMode ; 


short 


txSize; 


long 


spExtra; 


long 


fgColor; 


long 


bkColor; 


short 


colrBit; 


short 


patStretch; 


PicHandle picSave; 


RgnHandle rgnSave; 


PolyHandle polySave; 


QDProcsPtr grafProcs; 



} GrafPort, *GrafPtr; 



/* External Variable Declarations */ 



extern struct qd { 



char 


private [78]; 




long 


randSeed; 




BitMap 


screenBits; 




Cursor 


arrow; 




Pattern 


dkGray; 




Pattern 


ItGray; 




Pattern 


gray; 




Pattern 


black; 
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Pattern white; 
GrafPtr thePort; 



} qd; 



/* GrafPort Routines */ 

pascal void InitGraf (globalPtr) 

Ptr globalPtr; 
pascal void OpenPort (port) 

GrafPtr port; 
pascal void InitPort (port) 

GrafPtr port; 
pascal void ClosePort (port) 

GrafPtr port; 
pascal void SetPort (port) 

GrafPtr port; 
pascal void GetPort (port) 

GrafPtr *port; 
pascal void Graf Device (device) 

short device; 
pascal void SetPortBits (bm) 

BitMap *bm; 
pascal void PortSize (width, height) 

short width, height; 
pascal void MovePortTo (leftGlobal, rightGlobal) 

short leftGlobal, rightGlobal; 
pascal void SetOrigin(h, v) 

short h,v; 
pascal void SetClip(rgn) 

RgnHandle rgn ; 
pascal void GetClip(rgn) 

RgnHandle rgn ; 
pascal void ClipRect(r) 

Rect *r; 
pascal void BackPat(pat) 

Pattern *pat; 



/* Cursor Routines */ 

pascal void InitCursorO 
pascal void SetCursor (crsr) 

Cursor *crsr; 
pascal void HideCursorO 
pascal void ShowCursorO 
pascal void ObscureCursor () 



/* Line Routines */ 

pascal void HidePenO 
pascal void ShowPenO 
pascal void GetPen(pt) 

Point *pt; 
pascal void GetPenState (pnStatel 

PenState *pnState; 
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pascal void SetPenState (pnState) 

PenState *pnState; 
pascal void PenSize (width, height) 

short width, height; 
pascal void PenMode (mode) 

short mode; 
pascal void PenPat(pat) 

Pattern *pat; 
pascal void PenNormalO 
pascal void MoveTo(h,v) 

short h,v; 
pascal void Move(dh,dv) 

short dh,dv; 
pascal void LineTo(h,v) 

short h,v; 
pascal void Line(dh,dv) 

short dh,dv; 



/* Text Routines */ 

pascal void TextFont (font) 

short font; 
pascal void TextFace (face) 

Style face; 
pascal void TextMode (mode) 

short mode; 
pascal void TextSize (size) 

short size; 
pascal void SpaceExtra (extra) 

long extra; 
pascal void DrawChar(ch) 

short ch; 
void Drawstring (s) 

char *s; 
pascal void DrawText (textBuf, firstByte,byteCount) 

Ptr textBuf; 

short firstByte,byteCount; 
pascal short CharWidth(ch) 

short ch; 
short StringWidth(s) 

char *s; 
pascal short TextWidth (textBuf, firstByte,byteCount) 

Ptr textBuf; 

short firstByte,byteCount; 
pascal void GetFontlnfo (info) 

Fontlnfo *info; 



/* Drawing in Color */ 

pascal void ForeColor (color) 

long color" ; 
pascal void BackColor (color) 

long color; 
pascal void ColorBit (whichBit) 

short whichBit; 
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/* Rectangle Calculations */ 

pascal void SetRect (r, left, top, right, bottom) 

Rect *r; 

short left, top, right, bottom; 
pascal void OffsetRect (r,dh,dv) 

Rect *r; 

short dh,dv; 
pascal void InsetRect (r,dh,dv) 

Rect *r; 

short dh,dv; 
pascal Boolean SectRect (srcRectl,srcRect2,dstRect) 

Rect *srcRectl , *srcRect2 , *dstRect ; 
pascal void UnionRect (srcRectl, srcRect2,dstRect) 

Rect * srcRectl, *srcRect2, *dstRect; 
Boolean PtInRect (pt, r) 

Point *pt; 

Rect *r; 
void Pt2Rect (ptl,pt2,dstRect) 

Point *ptl, *pt2; 

Rect *dstRect; 
void PtToAngle (r,pt, angle) 

Rect *r; 

Point *pt; 

short *angle; 
pascal Boolean EqualRect (recti, rect2) 

Rect *rectl, *rect2; 
pascal Boolean EmptyRect(r) 

Rect *r; 



/* Graphical Operations on Rectangles */ 

pascal void FrameRect(r) 

Rect *r; 
pascal void PaintRect(r) 

Rect *r; 
pascal void EraseRect(r) 

Rect *r; 
pascal void InvertRect (r) 

Rect *r; 
pascal void FillRect (r,pat) 

Rect *r; 

Pattern *pat; 



/* Oval Routines */ 

pascal void FrameOval(r) 

Rect *r; 
pascal void PaintOval(r) 

Rect *r; 
pascal void EraseOval(r) 

Rect *r; 
pascal void InvertOval (r) 
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Rect *r; 
pascal void FillOval (r,pat) 
Rect *r; 
Pattern *pat; 



/* RoundRect Routines */ 

pascal void FrameRoundRect (r,ovalWidth,ovalHeight) 

Rect *r/ 

short ovalWidth, ovalHeight ; 
pascal void PaintRoundRect (r, ovalWidth, ovalHeight) 

Rect *r; 

short ovalWidth, ovalHeight; 
pascal void EraseRoundRect (r, ovalWidth, ovalHeight) 

Rect *r; 

short ovalWidth, ovalHeight; 
pascal void InvertRoundRect (r,ovalWidth, ovalHeight) 

Rect *r; 

short ovalWidth, ovalHeight; 
pascal void FillRoundRect (r,ovalWidth^ ovalHeight, pat) 

Rect *r; 

short ovalWidth, ovalHeight; 

Pattern *pat; 



/* Arc Routines */ 

pascal void FrameArc (r, startAngle,arcAngle) 

Rect *r; 

short startAngle,arcAngle; 
pascal void PaintArc (r, startAngle,arcAngle) 

Rect *r; 

short startAngle,arcAngle; 
pascal void EraseArc (r, startAngle,arcAngle) 

Rect *r; 

short St art Angle, arcAngle; 
pascal void Invert Arc (restart Angle, arcAngle) 

Rect *r; 

short St art Angle, arcAngle; 
pascal void FillArc(r,startAngle, arcAngle, pat) 

Rect *r; 

short startAngle, arcAngle; 

Pattern *pat; 



/* Region Calculations */ 

pascal RgnHandle NewRgn ( ) 
pascal void DisposeRgn (rgn) 

RgnHandle rgn; 
pascal void CopyRgn (srcRgn,dstRgn) 

RgnHandle srcRgn,dstRgn; 
pascal void SetEmptyRgn (rgn) 

RgnHandle rgn; 
pascal void SetRectRgn (rgn, left, top, right, bottom) 

RgnHandle rgn; 
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short left, top, right, bottom; 
pascal void RectRgn (rgn,r) 

RgnHandle rgn; 

Rect *r; 
pascal void OpenRgn () 
pascal void CloseRgn (dstRgn) 

RgnHandle dstRgn; 
pascal void Of fsetRgn (rgn,dh,dv) 

RgnHandle rgn ; 

short dh,dv; 
pascal void InsetRgn (rgn,dh,dv) 

RgnHandle rgn; 

short dh,dv; 
pascal void SectRgn (srcRgnA, srcRgnB, dstRgn) 

RgnHandle srcRgnA, srcRgnB, dstRgn; 
pascal void UnionRgn (srcRgnA, srcRgnB, dstRgn) 

RgnHandle srcRgnA, srcRgnB, dstRgn; 
pascal void Diff Rgn (srcRgnA, srcRgnB, dstRgn) 

RgnHandle srcRgnA, srcRgnB, dstRgn; 
pascal void XorRgn (srcRgnA, srcRgnB, dstRgn) 

RgnHandle srcRgnA, srcRgnB, dstRgn; 
Boolean PtInRgn (pt, rgn) 

Point *pt; 

RgnHandle rgn ; 
pascal Boolean RectInRgn(r, rgn) 

Rect *r; 

RgnHandle rgn; 
pascal Boolean EqualRgn (rgnA, rgnB) 

RgnHandle rgnA, rgnB; 
pascal Boolean EmptyRgn ( rgn ) 

RgnHandle rgn; 



/* Graphical Operations on Regions */ 

pascal void FrameRgn (rgn) 

RgnHandle rgn; 
pascal void PaintRgn(rgn) 

RgnHandle rgn; 
pascal void EraseRgn (rgn) 

RgnHandle rgn; 
pascal void Invert Rgn (rgn) 

RgnHandle rgn ; 
pascal void FillRgn (rgn,pat) 

RgnHandle rgn ; 

Pattern *pat; 



/* Graphical Operations on Bit Maps */ 

pascal void ScrollRect (r,dh,dv,updateRgn) 

Rect *r; 

short dh,dv; 

RgnHandle updateRgn; 
pascal void CopyBits (srcBits,dstBits, srcRect,dstRect,mode,inaskRgn) 

BitMap *srcBits, *dstBits; 

Rect *srcRect, *dstRect; 
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short mode; 
RgnHandle maskRgn; 



/* Picture Routines */ 

pascal PicHandle OpenPicture (picFrame) 

Rect *picFrame; 
pascal void PicComment (kind;.dataSize,dataHandle) 

short kind,dataSize; 

Handle dataHandle; 
pascal void ClosePicture () 
pascal void DrawPicture (myPicture^dstRect) 

PicHandle myPicture; 

Rect *dstRect; 
pascal void KillPicture (myPicture) 

PicHandle myPicture; 



/* Polygon Calculations */ 

pascal PolyHandle OpenPolyO 
pascal void ClosePolyO 
pascal void KillPoly (poly) 

PolyHandle poly; 
pascal void OffsetPoly (poly, dh^dv) 

PolyHandle poly; 

short dh,dv; 



/* Graphical Operations on Polygons */ 

pascal void FramePoly (poly) 

PolyHandle poly; 
pascal void PaintPoly (poly) 

PolyHandle poly; 
pascal void ErasePoly (poly) 

PolyHandle poly; 
pascal void InvertPoly (poly) 

PolyHandle poly; 
pascal void FillPoly (poly, pat) 

PolyHandle poly; 

Pattern *pat; 



/* Point Calculations */ 

void AddPt (srcPt,dstPt) 

Point *srcPt,*dstPt; 
void SubPt (srcPt,dstPt) 

Point *srcPt,*dstPt; 
pascal void SetPt (pt,h, v) 

Point *pt; 

short h,v; 
Boolean EqualPt (ptl,pt2) 

Point *ptl, *pt2; 
pascal void LocalToGlobal (pt) 
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Point *pt; 
pascal void GlobalToLocal (pt) 
Point *pt; 



/* Miscellaneous Utility Routines */ 

pascal short Random () 
pascal Boolean GetPixel (h, v) 

short h,v; 
void StuffHex(thingPtr^s) 

Ptr thingPtr; 

char *s; 
pascal void ScalePt (pt, srcRect^dstRect) 

Point *pt; 

Rect *srcRect, *dstRect/ 
pascal void MapPt (pt, srcRect,dstRect) 

Point *pt; 

Rect *srcRect, *dstRect; 
pascal void MapRect (r,srcRect,dstRect) 

Rect *r, *srcRect, *dstRect; 
pascal void MapRgn(rgn,srcRect,dstRect) 

RgnHandle rgn ; 

Rect *srcRect, *dstRect; 
pascal void MapPoly (poly, srcRect,dstRect; 

PolyHandle poly; 

Rect *srcRect,*dstRect; 



/* Bottleneck Interface */ 

pascal void SetStdProcs (procs) 

QDProcsPtr procs; 
void StdText (byteCount,textAddr,numer,denom) 

short byteCount; 

Ptr textAddr; 

Point *numer, *denom; 
void StdLine (newPt) 

Point *newPt; 
pascal void StdRect (verb, r) 

Graf Verb verb; 

Rect *r; 
pascal void StdRRect (verb,r,ovalWidth,ovalHeight) 

Graf Verb verb; 

Rect *r; 

short ovalWidth,ovalHeight; 
pascal void StdOval (verb, r) 

Graf Verb verb; 

Rect *r; 
pascal void StdArc (verb,r, startAngle,arcAngle) 

Graf Verb verb; 

Rect *r; 

short start Angle , arcAngle ; 
pascal void StdPoly (verb, poly) 

Graf Verb verb; 

PolyHandle poly; 
pascal void StdRgn (verb, rgn) 
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Graf Verb verb; 

RgnHandle rgn; 
pascal void StdBits (srcBits,srcRect,dstRect,mode,mask.Rgn) 

BitMap *srcBits; 

Rect *srcRect, *dstRect; 
short mode; 

RgnHandle maskRgn; 
pascal void StdComment (kind,dataSize,dataHandle) 

short kind^dataSize; 

Handle dataHandle; 
pascal short StdTxMeas (byteCount, text Addr,numer,denom, info) 

short byteCount; 

Ptr textAddr; 

Point *numer, *denom; 

Fontlnfo *info; 
pascal void StdGetPic (dataPtr, byteCount) 

Ptr dataPtr; 

short byteCount; 
pascal void StdPutPic (dataPtr, byteCount) 

Ptr dataPtr; 

short byteCount; 



USER ROUTINES 

pascal void MyText (byteCount, textAddr, numer,denom) 

short byteCount; 

Ptr textAddr; 

Point numer,denom; 
pascal void MyLine (newPt) 

Point newPt; 
pascal void MyRect (verb, r) 

Graf Verb verb; 

Rect *r; 
pascal void MyRRect (verb,r,ovWd, ovHt) 

Graf Verb verb; 

Rect *r; 

short ovWd,ovHt; 
pascal void MyOval (verb, r) 

Graf Verb verb; 

Rect *r; 
pascal void MyArc (verb, r, start Angle, a rcAngle) 

Graf Verb verb; 

Rect *r; 

short startAngle,arcAngle; 
pascal void MyPoly (verb, poly) 

Graf Verb verb; 

PolyHandle poly; 
pascal void My Rgn (verb, rgn) 

Graf Verb verb; 

RgnHandle rgn ; 
pascal void MyBits (srcBits,srcRect,dstRect, mode, maskRgn) 

BitMap *srcBits; 

Rect *srcRect, *dstRect; 

short mode; 

RgnHandle maskRgn; 
pascal void MyComment (kind, dataSize, dataHandle) 

short kind, dataSize; 
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Handle dataHandle; 
pascal short MyTxMeas (byteCount, textAddr,numer,denom, info) 

short byteCount; 

Ptr textAddr; 

Point *numer, *denoin; 

Font Info *info; 
pascal void MyGetPic (dataPtr, byteCount) 

Ptr dataPtr; 

short byteCount; 
pascal void MyPutPic (dataPtr, byteCount) 

Ptr dataPtr; 

short byteCount; 

DESCRIPTION 

QuickDraw is the Macintosh graphics package. 

Warning: User routines My Text and MyLine are not identical to their counterparts 
StdText and StdLine. Point parameters to My Text and MyLine are passed by value; 
the corresponding parameters to StdText and StdLine are passed by reference. 

For more detailed information see the QuickDraw chapter of Inside Macintosh. 
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NAME 



resources — ^Resource Manager 



SYNOPSIS 

tinclude <types.h> 
#include <resources .h> 



/* Resource Attributes */ 

#define resSysHeap 
#define resPurgeable 
#define resLocked 
#define resProtected 
#define resPreload 
tdefine resChanged 



64 

32 

16 

8 

4 

2 



/* Error Numbers */ 

#define resNotFound (-192) 

#define resFNotFound (-193) 

#define addResFailed (-194) 

#define rmvResFailed (-196) 

/* Resource File Attributes */ 

#define inapReadOnly 128 

#define mapCompact 64 

#define mapChanged 32 



/* set if read into system heap 

/* set if purgeable 

/* set if locked 

/* set if protected 

/* set if to be preloaded 

/* set if written to resource file 



/* resource not found 

/* resource file not found 

/* AddResource failed 

/* RmveResource failed 



/* set if file is read-only 

/* set to compact file on update 

/* set if write map on update 



/* typedef long ResType; appears in file TYPES */ 



/* Initialization */ 

pascal short InitResources () 
pascal void RsrcZonelnit () 



/* Opening and Closing Resource Files */ 

void CreateResFile (fileName) 

char * fileName; 
short OpenResFile (fileName) 

char * fileName ; 
pascal void CloseResFile (refNum) 

short refNum; 



/* Checking for Errors */ 
pascal short ResErrorO 

/* Setting the Current Resource File */ 
pascal short CurResFile ( ) 



*/ 
*/ 
*/ 
*/ 
*/ 



*/ 



*/ 
*/ 
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pascal short HomeResFile (theResource) 

Handle theResource; 
pascal void UseResFile (refNum) 

short refNum; 



/* Getting Resource Types */ 

pascal short CountTypesO 

pascal void Get IndType (theType, index) 

ResType *theType; 

short index; 



/* Getting and Displosing of Resources */ 

pascal void SetResLoad(load) 

Boolean load; 
pascal short CountResources (theType) 

ResType theType; 
pascal Handle GetlndResource (theType, index) 

ResType theType; 

short index; 
pascal Handle GetResource (theType, thelD) 

ResType theType; 

short thelD; 
Handle GetNamedResource (theType, name) 

ResType theType; 

char *name; 
pascal void LoadResource (theResource) 

Handle theResource; 
pascal void ReleaseResource (theResource) 

Handle theResource; 
pascal void DetachResource (theResource) 

Handle theResource; 



/* Getting Resource Information */ 

pascal short UniquelD (theType) 

ResType theType; 
void GetResInf o (theResource, thelD, theType, name) 

Handle theResource; 

short *theID; 

ResType *theType; 

char *name; 
pascal short GetResAttrs (theResource) 

Handle theResource; 
pascal long SizeResource (theResource) 

Handle theResource; 



/* Modifing Resources */ 

void SetResInf o (theResource, thelD, name) 
Handle theResource; 
short thelD; 
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char *name; 
pascal void SetResAttrs (theResource,attrs) 

Handle theResource; 

short attrs; 
pascal void ChangedResource (theResource) 

Handle theResource; 
void AddResource (theData,theType,theID,name) 

Handle theData; 

Res Type theType; 

short thelD; 

char *name; 
pascal void RmveResource (theResource) 

Handle theResource; 
pascal void UpdateResFile (refNum) 

short refNum; 
pascal void WriteResource (theResource) 

Handle theResource; 
pascal void SetResPurge (install) 

Boolean install; 

/* Advanced Routines */ 

pascal short GetResFileAttrs (refNum) 

short refNum; 
pascal void SetResFileAttrs (refNum, attrs) 

short refNum; 

short attrs; 



DESCRIPTION 

The Resource Manager provides access to Macintosh resource files. 

ResType may be specified as a character literal (e.g., 'MENU'). 

For more detailed information see the Resource Manager chapter of Inside 
Macintosh, 
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NAME 



retrace — Vertical Retrace Manager 



SYNOPSIS 

#include <types.h> 
tinclude <retrace.h> 



/* error codes */ 

#define noErr 
#define qErr 
fdefine vTypErr 



/* no error */ 
(-1) /* task entry isn't in the queue */ 
(-2) /* qType field isn't vType */ 



typedef struct VBLTask { 

struct QElem *qLink; 

short qType; 

ProcPtr vblAddr; 

short vblCount; 

short vblPhase; 
} VBLTask; 



/* next queue entry */ 

/* unique id for validity check */ 

/* address of service routine */ 

/* count field for timeout */ 

/* phase to allow synchronization */ 



OSErr Vlnstall(vblTaskPtr) 
QElemPtr vblTaskPtr; 

OSErr VRemove (vblTaskPtr) 
QElemPtr vblTaskPtr; 

struct QHdr *GetVBLQHdr ( ) 



DESCRIPTION 

The Vertical Retrace Manager schedules and performs recurrent tasks during 
vertical retrace interrupts. 

For more detailed information see the Vertical Retrace Manager chapter of Inside 
Macintosh. 
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NAME 



sane — ^S ANE Numerics 



SYNOPSIS 

finclude <sane.h> 



/* Decimal Representation Constants */ 



#define 


SIGDIGLEN 


20 


/* 


#define 


DECSTROUTLEN 


80 





/* Decimal Formatting Styles */ 



#define FLOATDECIMAL 
#define FIXEDDECIMAL 



significant decimal digits */ 

max length for decimal string */ 

output */ 



/* Exceptions */ 



#define 


INVALID 


1 


#define 


UNDERFLOW 


2 


fdefine 


OVERFLOW 


4 


#define 


DIVBYZERO 


8 


#define 


INEXACT 


16 



/* Ordering Relations */ 

#define GREATERTHAN 

#define LESS THAN 1 

#def ine EQUALTO 2 

#define UNORDERED 3 

/* Inquiry Classes */ 



#define 


SNAN 





#define 


QNAN 


1 


#define 


INFINITE 


2 


#define 


ZERONUM 


3 


#define 


NORJMALNUM 


4 


#define 


DENORMALNUM 


5 



/* Rounding Directions */ 

#define TONEAREST 

#define UPWARD 1 

#define DOWNWARD 2 

#define TOWARDZERO 3 

/* Rounding Precisions */ 

#define EXTPRECISION 

fdefine DBLPRECISION 1 

#define FLOATPRECISION 2 



typedef short exception; 



/* sum of INVALID ... INEXACT 



Page 134 



SANE Macintosh Interface Libraries SANE 



typedef short relop; /* relational operator */ 

typedef short numclass; /* inquiry class */ 

typedef short rounddir; /* rounding direction */ 

typedef short roundpre; /* rounding precision */ 
typedef short environment; 

typedef struct decimal { 

char sgn, unused; /* sign for +, 1 for - */ 

short exp; /* decimal exponent */ 

struct {unsigned char length, text [SIGDIGLEN] , unused} sig; 

/* significant digits */ 

} decimal; 

typedef struct decform { 

char style, unused; /* FLOATDECIMAL or FIXEDDECIMAL */ 

short digits; 
} decform; 

typedef void (*haltvector) () ; 

/* Conversions between Binary and Decimal Records */ 

void num2dec (f ,x,d) /* d < — x, according to format f */ 

decform *fi 

extended x; 

decimal *d; 
extended dec2num(d) /* returns d as extended */ 

decimal *d; 

/* Conversions between Decimal Records and ASCII Strings */ 

void dec2str (f ,d, s) /* s < — d, according to format f */ 
decform *f ; 
decimal *d; 
char *s; 

void str2dec (s, ix,d, vp) /* on input ix is starting index into s, on */ 

char *s; /* output ix is one greater than index of last*/ 

short *ix, *vp; /* character of longest numeric substring; */ 

decimal *d; /* boolean vp = "s begining at given ix is a */ 

/* valid numeric string or a valid prefix of */ 

/* some numeric string" */ 

/* Arithmetic, Auxiliary, and Elementary Functions */ 

extended f abs (x) /* absolute value */ 

extended x; 

extended remainder (x,y, quo) /* IEEE remainder; quo < — 7 low order */ 

extended x,y; /* bits of integer quotient x/y, */ 

short *quo; /* -127 <= quo <= 127 */ 

extended sqrt (x) /* square root */ 

extended x; 
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extended rint (x) 

extended x; 
extended scalb(n,x) 

short n; 

extended x; 
extended logb (x) 

extended x; 
extended copysign(x,y) 

extended x,y; 
extended nextfloat (x,y) 

extended x,y; 
extended nextdouble (x,y) 

extended x,y; 
extended nextextended(x,y) 

extended x,y; 
extended log2 (x) 

extended x; 
extended log (x) 

extended x; 
extended logl (x) 

extended x; 
extended exp2 (x) 

extended x; 
extended exp (x) 

extended x; 
extended expl (x) 

extended x; 
extended power (x,y) 

extended x,y; 
extended ipower(x,i) 

extended x; 

short i; 
extended compound (r,n) 

extended r,n; 
extended annuity (r,n) 

extended r,n; 
extended tan (x) 

extended x; 
extended sin(x) 

extended x; 
extended cos (x) 

extended x; 
extended atan(x) 

extended x; 
extended randoinx(x) 

extended *x; 

/* Inquiry Routines */ 

numclass classf loat (x) 

extended x; 
numclass classdouble (x) 

extended x; 
numclass classcomp(x) 

extended x; 
numclass classextended(x) 

extended x; 



/* round to integral value 
/* binary scale: x * 2'^n; 



*/ 



/* binary log: */ 

/* binary exponent of normalized x */ 
/* y with sign of x */ 

/* next float representation after */ 
/* (float) X in direction of (float) y*/ 
/* next double representation after */ 
/* (double) X in direction of (double) y */ 
/* next extended representation after x */ 
/* in direction of y 
/* base-2 log 

/* base-e log 

/* logd + x) 

/* base-2 exponential 

/* base-e exponential 

/* exp(x) - 1 

/* general exponential: x '^ y 

/* integer exponential: x '^ i 

/* compound: (1 + r) '^ n 

/* annuity: (1 - (1 + r) ^ (-n) ) / r 

/* tangent 

/* sine 

/* cosine 

/* arctangent 



*/ 
*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 

*/ 
*/ 
*/ 
*/ 
*/ 
*/ 



/* returns next random number; updates x; */ 
/* X integral, 1 <= x <= 2^31 - 2 */ 



/* class of (float) x 
/* class of (double) x 
/* class of (comp) x 
/* class of X 



*/ 
*/ 
*/ 
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long signnum(x) 
extended x; 



/* returns for +, 1 for - 



/* Environment Access Routines */ 
/* An exception variable encodes the exceptions 
whose sum is its value */ 



void setexception(e/ s) 

exception e; 

long s ; 
long testexception (e) 

exception e; 
void sethalt(e,s) 

exception e; 

long s; 
long testhalt(e) 

exception e; 
void setround(r) 

rounddir r; 
rounddir getroundO 
void setprecison (p) 

roundpre p; 
roundpre getprecsion () 
void setenvironment (e) 

environment e; 
void getenvironment (e) 

environment *e; 
void procentry(e) 

environment *e; 
void procexit(e) 

environment e; 
haltvector gethaltvector () 
void sethaltvector (v) 

haltvector v; 



/* clrs e flags if s is 0, sets e flags */ 
/* otherwise; may cause halt */ 



/* returns 1 if any e flag is set, 

/* returns otherwise 

/* disables e halts if s is 0, 

/* enables e halts otherwise 



/* returns rounding direction 

/* sets rounding precision to p 

/* returns rounding precision 

/* sets environment to e 

/* e < — environment 



/* 

/* 
/* 
/* 



e < — environment; 

environment < — IEEE default 
temp < — exceptions; environment <- 

signals exceptions in temp 
returns halt vector 
halt vector < — v 



*/ 
*/ 



/* returns 1 if any e halt is enabled, */ 
/* returns otherwise */ 

/* sets rounding direction to r */ 



*/ 
*/ 

*/ 



*/ 
*/ 
e; */ 
*/ 
*/ 
*/ 



/* Comparision Routine */ 

relop relation (x,y) 
extended x,y; 



extended nan(c) 

unsigned char c; 
extended inf ( ) 
extended pi () 



/* returns relation such that 
/* "x relation y" is true 



/* NaNs and Special Constants */ 



/* returns NaN with code c 

/* infinity 
/* pi 



DESCRIPTION 

These routines together with Apple's C language fully support the Standard Apple 
Numeric Environment (SANE). They comprise a scrupulously conforming 
implementation of extended-precision IEEE Standard 754 floating-point arithmetic. 

The Standard Apple Numeric Environment is documented in the Apple Numerics 
Manual. 



*/ 



*/ 
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NAME 

scrap — Scrap Manager 



SYNOPSIS 

finclude <types.h> 
#include <scrap.h> 



#define noScrapErr (-100) /* desk scrap isn't initialized */ 
#define noTypeErr (-102) /* no data of the requested type */ 

typedef struct ScrapStuff { 

long scrapSize; 

Handle scrapHandle; 

short scrapCount; 

short scrapState; 

StringPtr scrapName; 
} ScrapStuff, *PScrapStuf f ; 



/* Getting Desk Scrap Information */ 

pascal PScrapStuff InfoScrapO 

/* Keeping the Desk Scrap on the Disk */ 

pascal long UnloadScrapO 
pascal long LoadScrapO 

/* Reading from the Desk Scrap */ 

pascal long GetScrap(hDest,theType, offset) 
Handle hDest; 
ResType theType; 
long *offset; 

/* Writing to the Desk Scrap */ 

pascal long ZeroScrapO 

pascal long Put Scrap (length, theType, source) 

long length; 

ResType theType; 

Ptr source; 

DESCRIPTION 

The Scrap Manager provides a mechanism for cutting and pasting between 
applications and desk accessories. 

For more detailed information see the Scrap Manager chapter of Inside 
Macintosh, 
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NAME 



segload — Segment Loader 



SYNOPSIS 

#include <types.h> 
#include <segload.h> 



/* Message returned by CountAppFiles */ 



# define appOpen 
#define appPrint 



/* Open the document (s) */ 
/* Print the document (s) */ 



typedef struct AppFile { 



short 
OS Type 
short 
Str255 
} AppFile; 



vRefNum; 
fType; 
versNum; 
f Name ; 



/* volume reference number */ 

/* file type */ 

/* version number */ 

/* file name */ 



pascal void UnloadSeg(routineAddr) 

Ptr routineAddr; 
void CountAppFiles (message, count) 

short ^message, *count; 
void Get AppFiles (index, theFile) 

short index; 

AppFile *theFile; 
void ClrAppFiles (index) 

short index; 
void GetAppParms (apName, apRefNum, apParam) 

char *apName; 

short *apRefNum; 

Handle *apParam; 
pascal void ExitToShell () 



DESCRIPTION 

The Segment Loader is the part of the Macintosh Operating System that lets you 
divide your application into several parts and have only some of them in memory at 
a time. When an application starts up, the Segment Loader also provides it with a 
list of files to open or print. 

For more detailed information see the Segment Loader chapter of Inside 
Macintosh. 
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NAME 



serial — Serial Drivers 



SYNOPSIS 

finclude <types.h> 
finclude <serial.h> 



/* Driver reset information */ 



fdefine 


bauds 00 


S80 


/* 


300 baud 


*/ 


#define 


bauds 00 


18 9 


/* 


600 baud 


*/ 


fdefine 


baudl200 


94 


/* 


1200 baud 


*/ 


#define 


baudlSOO 


62 


/* 


18 00 baud 


*/ 


fdefine 


baud2 400 


46 


/* 


2 400 baud 


*/ 


tdefine 


bauds 600 


30 


/* 


3600 baud 


*/ 


#define 


baud4 800 


22 


/* 


4800 baud 


*/ 


fdefine 


baud7200 


14 


/* 


7200 baud 


*/ 


fdefine 


baud9600 


10 


/* 


9600 baud 


*/ 


fdefine. 


baudl9200 


4 


/* 


19200 baud 


*/ 


fdefine 


baud57 600 





/* 


57600 baud 


*/ 


fdefine 


stoplO 


16384 


/* 


1 stop bit 


*/ 


fdefine 


stoplS 


(-32768) 


/* 


1.5 stop bits */ 


fdefine 


stop20 


(-16384) 


/* 


2 stop bits 


*/ 


fdefine 


noParity 





/* 


no parity * 


/ 


fdefine 


oddParity 


4096 


/* 


odd parity 


*/ 


fdefine 


evenParity 


12288 


/* 


even parity 


' */ 


fdefine 


data 5 





/* 


5 data bits 


*/ 


fdefine 


data 6 


2048 


/* 


6 data bits 


*/ 


fdefine 


data? 


1024 


/* 


7 data bits 


*/ 


fdefine 


data 8 


3072 


/* 


8 data bits 


*/ 



/* Masks for errors */ 

fdefine swOverrunErr 1 

fdefine parityErr 16 

fdefine hwOverrunErr 32 

fdefine framingErr 64 



/* set if software overrun error */ 

/* set if parity error */ 

/* set if hardware overrun error */ 

/* set if framing error */ 



/* Masks for changes that cause events to be posted */ 

fdefine ctsEvent 32 /* set if CTS change will cause event */ 

/* to be posted */ 

fdefine breakEvent 128 /* set if break status change will */ 

/* cause event to be posted */ 

/* Indication that an XOFF character was sent */ 

fdefine xOffWasSent 0x80 /* XOFF character was sent */ 



/* Result codes */ 
fdefine noErr 



/* no error */ 
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#define openErr 



( -23) /* Open of RAM Serial Driver failed */ 



typedef enum { 

sPortA, 

sPortB 
} SPortSel; 

typedef struct SerShk { 

char fXOn; 

char fCTS; 

unsigned char xOn; 

unsigned char xOff; 

char errs; 

char evts; 

char fInX; 

char null; 
} SerShk; 



/* modem port */ 
/* printer port */ 



/* 
/* 
/* 
/* 
/* 
/* 
/* 



XON/XOFF output flow control flag */ 
CTS hardware handshake flag */ 
XOn character */ 
XOff character */ 
errors that cause abort */ 
status changes that cause events 
XOn/XOff input flow control flag 
not used */ 






typedef struct SerStaRec { 

char cumErrs; 

char xOffSent; 

char rdPend; 

char wrPend; 

char ctsHold; 

char xOffHold; 
} SerStaRec; 



/* cumulative errors */ 

/* XOff sent as input flow control */ 

/* read pending flag */ 

/* write pending flag */ 

/* CTS flow control hold flag */ 

/* XOff received as output flow control */ 



/* Opening and Closing the RAM Serial Driver */ 

OSErr RAMSDOpen (whichPort) 

SPortSel whichPort; 
void RAMSDClose (whichPort) 

SPortSel whichPort; 



/* Changing Serial Driver Information */ 

OSErr SerReset (refNum, serConf ig) 

short refNum, serConf ig; 
OSErr SerSetBuf (refNum, serBPtr, serBLen) 

short refNum; 

Ptr serBPtr; 

short serBLen; 
OSErr SerHShake (refNum, flags) ; 

short refNum; 

SerShk *flags; 
OSErr SerSetBrk( refNum) 

short refNum; 
OSErr SerClrBrk (refNum) 

short refNum; 



/* Getting Serial Driver Information */ 
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OSErr SerGetBuf (re fNum, count) 

short refNum; 

long *count; 
OSErr SerStatus (refNum, serSta) 

short refNum; 

SerStaRec *serSta; 

DESCRIPTION 

The RAM Serial Driver and the ROM Serial Driver are Macintosh device drivers for 
handling asynchronous serial communication between a Macintosh application and 
serial devices. 

For more detailed information see the Serial Drivers chapter of Inside 
Macintosh, 
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NAME 



sound — Sound Driver 



SYNOPSIS 

#include <types.h> 
♦include <sound.h> 



/* Mode values for synthesizers */ 



#define swMode 
♦define ftMode 
♦define ffMode 



(-1) /* square-wave synthesizer */ 
1 /* four-tone synthesizer */ 
/* free-form synthesizer */ 



/* Free-Form synthesizer */ 

typedef unsigned char FreeWave [30001] ; 



typedef struct FFSynthRec { 

short mode; 

Fixed count; 

FreeWave waveBytes; 
} FFSynthRec, *FFSynthPtr; 



/* always ffMode */ 

/* "sizing" factor */ 

/* waveform description */ 



/* Square-Wave synthesizer */ 

typedef struct Tone { 

short count; 

short amplitude; 

short duration; 
} Tone; 

typedef Tone Tones [5001]; 

typedef struct SWSynthRec { 

short mode; 

Tones triplets; 
} SWSynthRec, *SWSynthPtr; 



/* frequency */ 

/* amplitude, 0-255 */ 

/* duration in ticks */ 



/* always swMode */ 
/* sounds */ 



/* Four-Tone Synthesizer */ 
typedef unsigned char Wave [256]; 



typedef Wave *WavePtr; 
typedef struct FTSoundRec { 



short 


duration; 


/* c 


Fixed 


soundlRate; 


/* 1 


long 


soundlPhase; 


/* 1 


Fixed 


sound2Rate; 


/* 1 


long 


sound2Phase; 


/* 1 


Fixed 


soundSRate; 


/* 1 


long 


soundSPhase; 


/* 1 


Fixed 


sound4Rate; 


/* 1 
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duration in ticks */ 
tone 1 cycle rate */ 
tone 1 byte offset */ 
tone 2 cycle rate */ 
tone 2 byte offset */ 
tone 3 cycle rate */ 
/* tone 3 byte offset */ 
/* tone 4 cycle rate */ 
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long 


sound4Phase; 


/* 


WavePtr 


soundlWave; 


/* 


WavePtr 


sound2Wave; 


/* 


WavePtr 


soundSWave; 


/* 


WavePtr 


sound4Wave; 


/* 



} FTSoundRec, *FTSndRecPtr; 

typedef struct FTSynthRec { 

short mode; 

FTSndRecPtr sndRec; 
} FTSynthRec, *FTSynthPtr; 



tone 4 byte offset ■ 

tone 1 wave form */ 

/* tone 2 wave form */ 

tone 3 wave form */ 

tone 4 wave form */ 



/* always ftMode */ 
/* tones to play */ 



void St art Sound { synthRec , numBytes , complet ionRtn ) 

Ptr synthRec; 

long numBytes; 

ProcPtr complet ionRtn; 
void StopSoundO 
Boolean SoundDoneO 
void Get SoundVol (level) 

short *level; 
void Set SoundVol (level) 

short level 



DESCRIPTION 

The Sound Driver is a Macintosh device driver for handling sound and music 
generation in a Macintosh application. 

For more detailed information see the Sound Driver chapter of Inside 
Macintosh. 
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NAME 

strings — string conversions 

SYNOPSIS 

#include <types.h> 
#include <strings.h> 

String (0) *c2pstr(s) 

char *s; 
char *p2cstr(s) 

String (0) *s; 

DESCRIPTION 

Clpstr converts s from a C string to a Pascal string. Plcstr converts s from a 
Pascal string to a C string. Both conversions are done in place. For convenience, 
clpstr and plcstr return s as their function result. Both functions will accept nil 
as their parameter and do nothing. 

Pascal strings begin with a length byte. C strings are terminated by a zero byte. 
The macro String is defined in file types. h. 
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NAME 



textedit — ^TextEdit 



SYNOPSIS 

finclude <types.h> 
tinclude <textedit.h> 



#define teJustLeft 
#define teJustCenter 1 
#define teJustRight (-1) 

typedef char Chars [32001] ; 

typedef Chars *CharsPtr, **CharsHandle; 



typedef struct TERec { 

Rect destRect; 

Rect viewRect ; 

Rect selRect; 

short lineHeight; 

short fontAscent; 

Point selPoint; 

short selStart; 

short selEnd; 

short active; 

ProcPtr wordBreak; 

ProcPtr clikLoop; 

long clickTime; 

short clickLoc; 

long caretTime; 

short caret State; 

short just; 

short teLength; 

Handle hText ; 

short recalBack; 

short recalLines; 

short clikStuff; 

short crOnly; 

short txFont; 

Style txFace; 

short txMode; 

short txSize; 

struct Graf Port *inPort; 

ProcPtr highHook; 

ProcPtr caretHook; 

short nLines; 

short lineStarts [16001] ; 
} TERec, *TEPtr, **TEHandle; 



/* 



*/ 



/* destination rectangle */ 

/* view rectangle */ 

/* select rectangle */ 

current font lineheight */ 
current font ascent */ 
selection point (mouseLoc) */ 

/* selection start */ 

/* selection end */ 

/* != if active */ 

/* word break routine 

/* click loop routine 

/* time of first click */ 

/* char, location of click */ 

/* time for next caret blink */ 

/* on/active booleans */ 

/* fill style */ 

/* length of text below */ 

/* handle to actual text */ 

/* != if recal in background */ 

/* line being recalulated */ 

/* click stuff (internal) */ 

/* set to -1 if CR Line breaks only */ 

/* text Font */ 

/* text Face */ 

/* text Mode */ 

/* text Size */ 

/* GrafPort */ 

/* highlighting hook */ 

/* highlighting hook */ 

/* number of lines */ 

/* line starts */ 



/* Initialization and Allocation */ 

pascal void TEInitO 

pascal TEHandle TENew( destRect, viewRect] 

Rect *destRect, * viewRect; 
pascal void TEDispose (h) 

TEHandle h; 
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/* Accessing Text */ 

pascal void TESetText (text, length, hTE) 

Ptr text; 

long length; 

TEHandle hTE; 
pascal CharsHandle TEGetText (hTE) 

TEHandle hTE; 

/* Insertion Point and Selection Range */ 

pascal void TEIdle(hTE) 

TEHandle hTE; 
void TEClick(pt, extend, hTE) 

Point *pt; 

Boolean extend; 

TEHandle hTE; 
pascal void TESetSelect (selStart,selEnd, hTE) 

long selStart; 

long selEnd; 

TEHandle hTE; 
pascal void TEActivate (hTE) 

TEHandle hTE; 
pascal void TEDeactivate (hTE) 

TEHandle hTE; 

/* Editing */ 

pascal void TEKey (key,hTE) 

short key; 

TEHandle hTE; 
pascal void TECut (hTE) 

TEHandle hTE; 
pascal void TECopy(hTE) 

TEHandle hTE; 
pascal void TEPaste (hTE) 

TEHandle hTE; 
pascal void TEDelete (hTE) 

TEHandle hTE; 
pascal void TEInsert (text, length, hTE) 

Ptr text; 

long length; 

TEHandle hTE; 

/* Text Display and Scrolling */ 

pascal void TESet Just (just, hTE) 

short just; 

TEHandle hTE; 
pascal void TEUpdate (rUpdate,hTE) 

Rect *rUpdate; 

TEHandle hTE; 
pascal void TextBox (text, length, box, just) 

Ptr text; 

long length; 

Rect *box; 

short just; 
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pascal void TEScroll (dh,dv,hTE) 
short dh; 
short dv; 
TEHandle hTE; 

/* Scrap Information */ 

OSErr TEFromScrap () 
OSErr TEToScrapO 
Handle TEScrapHandle () 
long TEGetScrapLenO 
void TESetScrapLen (length) 
long length; 

/* Advanced Routines */ 

void SetWordBreak(wBrkProc,hTE) 

ProcPtr wBrkProc; 

TEHandle hTE; 
void SetClikLoop (clikProc, hTE ) 

ProcPtr clikProc; 

TEHandle hTE; 
pascal void TECalText (hTE) 

TEHandle hTE; 



USER ROUTINES 

Pascal Boolean MyWordBreak(text,charPos) 

Ptr text; 

short charPos; 
Pascal Boolean MyClikLoopO 

DESCRIPTION 

The TextEdit package provides basic text fonnatting and editing. 

For more detailed information see the TextEdit chapter of Inside Macintosh. 



NOTE 



The user routines highHook and caretHook are called with register conventions 
and therefore can't be C routines. 
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NAME 

toolutils — ^Toolbox Utilities 



SYNOPSIS 

tinclude <types.h> 
#include <toolutils .h> 



#define sysPatListID /* resource ID of standard pattern list */ 

fdefine iBeamCursor 1 /* text selection */ 

fdefine crossCursor 2 /* drawing graphics */ 

#define plusCursor 3 /* cell selection */ 

#define watchCursor 4 /* indicating long delay */ 



typedef struct Int64Bit { 

long hiLong; 

long loLong; 
} Int64Bit; 

typedef struct Cursor *CursPtr, **CursHandle; 
typedef struct Pattern *PatPtr, **PatHandle; 

/* Fixed-Point Arithmetic */ 

pascal Fixed FixRatio (numer,denom) 

short numer, denom; 
pascal Fixed FixMul(a,b) 

Fixed a,b; 
pascal short FixRound(x) 

Fixed x; 

/* String Manipulation */ 

StringHandle NewString (theString) 

char *theString; 
void SetString(h, theString) 

StringHandle h; 

char *theString; 
pascal StringHandle GetString(stringlD) 

short stringID; 
void GetlndString (theString, strListID, index) 

char *theString; 

short StrListID; 

short index; 

/* Byte Manipulation */ 

pascal long Munger (h,offset,ptrl,lengthl,ptr2,length2) 

Handle h; 

long offset; 

Ptr ptrl; 

long length 1; 

Ptr ptr2; 

long length2; 
pascal void PackBits (srcPtr,dstPtr,srcBytes) 
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Ptr *srcPtr; 
Ptr *dstPtr; 
short srcBytes; 
pascal void UnpackBits (srcPtr,dstPtr,dstBytes) 
Ptr *srcPtr; 
Ptr *dstPtr; 
short dstBytes; 

/* Bit Manipulation */ 

pascal Boolean BitTst (bytePtr,bitNum) 

Ptr bytePtr; 

long bitNum; 
pascal void BitSet (bytePtr, bitNum) 

Ptr bytePtr; 

long bitNum; 
pascal void BitClr (bytePtr, bitNum) 

Ptr bytePtr; 

long bitNum; 

/* Logical Operations */ 

pascal long BitAnd(valuel, value2) 

long valuel, value2; 
pascal long BitOr (valuel, value2) 

long valuel, value2; 
pascal long BitXor (valuel, value2) 

long valuel, value2; 
pascal long BitNot (value) 

long value; 
pascal long BitShift (value, count) 

long value; 

short count; 

/* Other Operations on Ints */ 

pascal short HiWord(x) 

long x; 
pascal short LoWord(x) 

long x; 
pascal void LongMul (a,b,dest) 

long a,b; 

Int64Bit *dest; 

/* Graphics Utilities */ 

void ScreenRes (scrnHRes, scrnVRes) 

short * scrnHRes; 

short * scrnVRes; 
pascal Handle Getlcon (iconID) 

short iconID; 
pascal void PlotIcon(theRect,theIcon) 

Rect *theRect ; 

Handle the Icon; 
pascal PatHandle GetPattern(patlD) 

short pat ID; 
void GetlndPattern (thePattern,patListID, index) 
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struct Pattern *thePattern; 

short patListID; 

short index; 
pascal CursHandle GetCursor (cursorlD) 

short cursorlD; 
void ShieldCursor (shieldRect,off setPt) 

Rect *shieldRect; 

Point *offsetPt; 
pascal struct Picture **GetPicture (picID) 

short picID; 

/* Miscellaneous Utilities */ 

long DeltaPoint (ptA,ptB) 
Point *pt Ap- 
point *ptB; 

pascal Fixed SlopeFromAngle (angle) 
short angle; 

pascal short AngleFromSlope (slope) 
Fixed slope; 

DESCRIPTION 

The Toolbox Utilities provide fixed-point arithmetic; string, byte, and bit 
manipulation; logical operations; and some graphics utilities. 

Warning: NewString and GetString return handles to Pascal strings. 
SetString takes a C string as its parameter and converts it to a Pascal string before 
storing it in the memory location referred to by the string handle. 

For more detailed information see the ToolBox Utilities chapter of Inside 
Macintosh. 
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NAME 

types — common defines and types 

SYNOPSIS 

#include <types.h> 

#define nil 
fdefine NULL 

typedef enum {false, true} Boolean; 

typedef char *Ptr; 

typedef Ptr *Handle; 

typedef long (*ProcPtr) () ; 

typedef ProcPtr *ProcHandle; 

typedef long Fixed; 

typedef unsigned long ResType; 

typedef long OSType; 

typedef short OSErr; 

typedef short Style; 

typedef struct Point { 

short v; 

short h; 
} Point; 
typedef struct Rect { 



short 


top; 


short 


left; 


short 


bottom; 


short 


right ; 


} Rect; 





#define String (size) struct {\ 

unsigned char length; unsigned char text [size];} 
typedef String (255) Str255, *StringPtr, **StringHandle; 

DESCRIPTION 

These defines and types are shared by several Macintosh libraries. 

The define String approximates Pascal strings. It creates a struct, not an array. 
Remember to use & when passing structs as parameters. 
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NAME 

windows — ^Window Manager 

SYNOPSIS 

♦include <types.h> 

♦include <quickdraw.h> 

♦include <windows.h> 



/* Window Definition Procedure IDs */ 

♦define documentProc 

♦define dBoxProc 1 

♦define plainDBox 2 

♦define altDBoxProc 3 

♦define noGrowDocProc 4 

♦define rDocProc 16 

/* Types of Windows */ 

♦define dialogKind 2 

♦define userKind 8 

/* FindWindow Result Codes */ 

♦define inDesk 

♦define inMenuBar 1 

♦define inSysWindow 2 

♦define inContent 3 

♦define inDrag 4 

♦define inGrow 5 

♦define inGoAway 6 

/* Axis Constraints for DragGrayRgn */ 

♦define noConstraint 

♦define hAxisOnly 1 

♦define vAxisOnly 2 

/* Messages to window definition functions */ 

♦define wDraw 

♦define wHit 1 

♦define wCalcRgns 2 

♦define wNew 3 

♦define wDispose 4 

♦define wGrow 5 

♦define wDrawGIcon 6 

/* defProc Hit Test Codes */ 

♦define wNoHit 

♦define wInContent 1 

♦define wInDrag 2 

♦define wInGrow 3 

♦define wInGoAway 4 
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#define deskPatID 16 
typedef GrafPtr WindowPtr; 

typedef struct WindowRecord { 

Graf Port port; 

short windowKind; 

Boolean visible; 

Boolean hilited; 

Boolean goAwayFlag; 

Boolean spareFlag; 

RgnHandle strucRgn; 

RgnHandle contRgn; 

RgnHandle updateRgn; 

ProcHandle windowDefProc; 

Handle dataHandle; 

StringHandle titleHandle; 

short titleWidth; 

struct ControlRecord **controlList; 

struct WindowRecord *nextWindow; 

PicHandle windowPic; 

long re f Con; 

} WindowRecord, *WindowPeek; 

/* Initialization and Allocation */ 

pascal void InitWindows ( ) 
pascal void GetWMgrPort (wPort) 

GrafPtr *wPort; 
WindowPtr NewWindow (wStorage,boundsRect, title, visible, procID, behind, 
goAwayFlag, ref Con) 

Ptr wStorage; 

Rect *boundsRect ; 

char *title; 

Boolean visible; 

short procID; 

WindowPtr behind; 

Boolean goAwayFlag; 

long ref Con; 
pascal WindowPtr GetNewWindow(windowID, wStorage, behind) 

short windowID; 

Ptr wStorage; 

WindowPtr behind; 
pascal void CloseWindow(theWindow) 

WindowPtr theWindow; 
pascal void DisposeWindow (theWindow) 

WindowPtr theWindow; 

/* Window Display */ 

void SetWTitle (theWindow, title) 

WindowPtr theWindow; 

char *title; 
void GetWTitle (theWindow, title) 

WindowPtr theWindow; 

char * title; 
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pascal void SelectWindow (theWindow) 

WindowPtr theWindow; 
pascal void HideWindow (theWindow) 

WindowPtr theWindow; 
pascal void ShowWindow (theWindow) 

WindowPtr theWindow; 
pascal void ShowHide (theWindow, showFlag) 

WindowPtr theWindow; 

Boolean showFlag; 
pascal void HiliteWindow (theWindow, fHiLite) 

WindowPtr theWindow; 

Boolean fHiLite; 
pascal void BringToFront (theWindow) 

WindowPtr theWindow; 
pascal void SendBehind (theWindow, behindWindow) 

WindowPtr theWindow; 

WindowPtr behindWindow; 
pascal WindowPtr FrontWindow ( ) 
pascal void DrawGrowIcon (theWindow) 

WindowPtr theWindow; 

/* Mouse Location */ 

short FindWindow (thePt, theWindow) 

Point *thePt; 

WindowPtr * the Window; 
Boolean TrackGoAway (theWindow, thePt ) 

WindowPtr theWindow; 

Point *thePt; 

/* Window Movement and Sizing */ 

pascal void MoveWindow (theWindow, hGlobal,vGlobal, front) 

WindowPtr theWindow; 

short hGlobal, vGlobal; 

Boolean front; 
void DragWindow (theWindow, startPt,boundsRect) 

WindowPtr theWindow; 

Point *startPt; 

Rect *boundsRect ; 
long GrowWindow (theWindow, startPt, sizeRect) 

WindowPtr theWindow; 

Point *startPt; 

Rect *sizeRect; 
pascal void SizeWindow (theWindow, w, h, f Update) 

WindowPtr theWindow; 

short w,h; 

Boolean f Update; 

/* Update Region Maintenance */ 

pascal void InvalRect (badRect) 

Rect *badRect ; 
pascal void InvalRgn(badRgn) 

RgnHandle badRgn; 
pascal void ValidRect (goodRect) 

Rect *goodRect ; 
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pascal void ValidRgn (goodRgn) 

RgnHandle goodRgn; 
pascal void BeginUpdate (theWindow) 

WindowPtr theWindow; 
pascal void EndUpdate (theWindow) 

WindowPtr theWindow; 

/* Miscellaneous Utilities */ 

pascal void SetWRef Con (theWindow, data) 

WindowPtr theWindow; 

long data; 
pascal long GetWRef Con (theWindow) 

WindowPtr theWindow; 
pascal void SetWindowPic (theWindow, pic) 

WindowPtr theWindow; 

PicHandle pic; 
pascal PicHandle GetWindowPic (theWindow) 

WindowPtr theWindow; 
long PinRect (theRect,thePt) 

Rect *theRect; 

Point *thePt; 
long DragGrayRgn (theRgn, startPt, limitRect, slopRect, axis, act ionProc) 

RgnHandle theRgn; 

Point *startPt; 

Rect *limitRect; 

Rect *slopRect; 

short axis; 

ProcPtr actionProc; 

/* Low- Level Routines */ 

pascal Boolean CheckUpdate (theEvent) 

struct EventRecord *theEvent; 
pascal void ClipAbove (window) 

WindowPeek window; 
pascal void SaveOld (window) 

WindowPeek window; 
pascal void DrawNew (window, update) 

WindowPeek window; 

Boolean update; 
pascal void PaintOne (window, clobberedRgn) 

WindowPeek window; 

RgnHandle clobberedRgn; 
pascal void PaintBehind(startWindow, clobberedRgn) 

WindowPeek startWindow; 

RgnHandle clobberedRgn; 
pascal void CalcVis (window) 

WindowPeek window; 
pascal void CalcVisBehind (startWindow, clobberedRgn) 

WindowPeek startWindow; 

RgnHandle clobberedRgn; 



USER ROUTINES 

pascal MyActionO 
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pascal long MyWindow(varCode,theWindow, message, param) 
short varCode; 
WindowPtr theWindow; 
short message; 
long pa ram; 

DESCRIPTION 

The Window Manager provides routines for creating and manipulating windows. 

For more detailed information see the Window Manager chapter of Inside 
Macintosh. 
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8. Library Index 

The Library Index contains an index entry for all the defines, types, enumeration literals, global variables, 
and functions defined in the Standard C Library section and the Macintosh Interface Libraries section. These 
sections are organized alphabetically by library header. 

Column 1 contains an alphabetical list of the index entries. 

Column 2 specifies the type of declaration (for example, literal) for the index entry. 

Column 3 contains the library header under which documentation for the index entry can be found in 
Section 6 or 7. If column 3 contains "(C)" following the library header — for example, abs(C) — ^look in the 
Standard C Library section. Otherwise, look in the Macintosh Interface Libraries section. 
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Identifier 

abbrevDate 

abortErr 

abs 

acos 

activateEvt 

activeFlag 

activMask 

AddDrive 

AddPt 

addResFailed 

AddResMenu 

AddResource 

Alert 

Alert Template 

AlertTHndl 

Alert TPtr 

Allocate 

alphaLock 

altDBoxProc 

AngleFromSlope 

annuity 

applEvt 

applMask 

app2Evt 

app2Mask 

app3Evt 

appSMask 

app4Evt 

app4Mask 

AppendMenu 

AppFile 

appleMark 

applFont 

ApplicZone 

appOpen 

appPrint 

asin 

at an 

at an 

at an 2 

athens 

atof 

atoi 

autoKey 

autoKeyMask 

autoTrack 

BackColor 

BackPat 

badBtSlpErr 

badCksrtiErr 

badDBtSlp 

badDCksum 

badMDBErr 

badUnitErr 

baudl200 

baudlSOO 

baudl9200 

baud2400 

bauds 00 

baud3600 

baud4800 

baud57600 



lypg 

literal 

define 

function 

function 

define 

define 

define 

function 

function 

define 

function 

function 

function 

type 

type 

type 

function 

define 

define 

function 

function 

define 

define 

define 

define 

define 

define 

define 

define 

function 

type 

define 

define 

function 

define 

define 

function 

function 

function 

function 

define 

function 

function 

define 

define 

define 

function 

function 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 



Library 

packages 

devices 

abs(C) 

trig(C) 

events 

events 

events 

files 

quickdraw 

resources 

menus 

resources 

dialogs 

dialogs 

dialogs 

dialogs 

files 

events 

windows 

toolutils 

sane 

events 

events 

events 

event s 

event s 

events 

events 

events 

menus 

segload 

fonts 

fonts 

memory 

segload 

segload 

trig(C) 

sane 

trig(C) 

trig(C) 

fonts 

atof (C) 

atoi(C) 

events 

events 

controls 

quickdraw 

quickdraw 

disks 

disks 

disks 

disks 

files 

devices 

serial 

serial 

serial 

serial 

serial 

serial 

serial 

serial 



baudeoo 

baud7200 

baud9600 

bdConv 

bDevCItoh 

bDevLaser 

bdNamErr 

bDraftLoop 

BeginUpdate 

BitAnd 

BitClr 

BitMap 

BitNot 

BitOr 

Bitsie 

BitSet 

BitShift 

BitTst 

BitXor 

blackBit 

blackColor 

BlockMove 

blueBit 

blueColor 

bold 

Boolean 

breakEvent 

BringToFront 

bSpoolLoop 

btnCtrl 

btnState 

BUFSIZ 

Button 

c2pstr 

Cairo 

calcCRgns 

CalcMenuSize 

CalcVis 

CalcVisBehind 

calloc 

cancel 

cantStepErr 

CautionAlert 

ceil 

century 

ChangedResource 

char 

char 

charCodeMask 

Chars 

CharsHandle 

CharsPtr 

CharWidth 

checkBoxProc 

Checkltem 

checkMark 

CheckUpdate 

chkCtrl 

classcomp 

classdouble 

classext ended 

classf loat 

clearerr 



define 

define 

define 

define 

define 

define 

define 

define 

function 

function 

function 

type 

function 

function 

type 

function 

function 

function 

function 

define 

define 

function 

define 

define 

define 

type 

define 

function 

define 

define 

define 

define 

function 

function 

define 

define 

function 

function 

function 

function 

define 

define 

function 

function 

define 

function 

type 

type 

define 

type 

type 

type 

function 

define 

function 

define 

function 

define 

function 

function 

function 

function 

macro 



serial 

serial 

serial 

packages 

printing 

printing 

files 

printing 

windows 

toolutils 

toolutils 

quickdraw 

toolutils 

toolutils 

quickdraw 

toolutils 

toolutils 

toolutils 

toolutils 

quickdraw 

quickdraw 

memory 

quickdraw 

quickdraw 

quickdraw 

types 

serial 

windows 

printing 

dialogs 

events 

setbuf (C) 

events 

strings 

fonts 

controls 

menus 

windows 

windows 

malloc (C) 

dialogs 

disks 

dialogs 

floor(C) 

packages 

resources 

quickdraw 

sound 

event s 

textedit 

text edit 

textedit 

quickdraw 

controls 

menus 

fonts 

windows 

dialogs 

sane 

sane 

sane 

sane 

ferror <C) 
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ClearMenuBar 


function 


menus 


dataVerErr 


define 


disks 


ClipAbove 


function 


windows 


Date2Secs 


function 


osutils 


ClipRect 


function 


quickdraw 


DateForm 


type 


packages 


clkRdErr 


define 


osutils 


DateTimeRec 


type 


osutils 


clkWrErr 


define 


osutils 


dayLdingZ 


define 


packages 


close 


function 


close (C) 


DBLPRECISION 


define 


sane 


CloseDeskAcc 


function 


desk 


dBoxProc 


define 


windows 


CloseDialog 


function 


dialogs 


DCtlEntry 


type 


devices 


CloseDriver 


function 


devices 


DCtlHandle 


type 


devices 


ClosePicture 


function 


quickdraw 


DCtlPtr 


type 


devices 


ClosePoly 


function 


quickdraw 


dec2num 


function 


sane 


ClosePort 


function 


quickdraw 


dec2str 


function 


sane 


CloseResFile 


function 


resources 


decform 


type 


sane 


CloseRgn 


function 


quickdraw 


decimal 


type 


sane 


CloseWindow 


function 


windows 


DECSTROUTLEN 


define 


sane 


ClrAppFiles 


function 


segload 


Delay 


function 


osutils 


cmdKey 


define 


events 


DeleteMenu 


function 


menus 


CntrlParam 


type 


devices 


DeltaPoint 


function 


toolutils 


ColorBit 


function 


quickdraw 


DENORMALNUM 


define 


sane 


commandMark 


define 


fonts 


Dequeue 


function 


osutils 


CompactMem 


function 


memory 


deskPatID 


define 


windows 


compound 


function 


sane 


DetachResource 


function 


resources 


condense 


define 


quickdraw 


dialogKind 


define 


windows 


Control 


function 


devices 


DialogPeek 


type 


dialogs 


controlErr 


define 


devices 


DialogPtr 


type 


dialogs 


ControlHandle 


type 


controls 


DialogRecord 


type 


dialogs 


ControlPtr 


type 


controls 


DialogSelect 


function 


dialogs 


ControlRecord 


type 


controls 


DialogTemplate 


type 


dialogs 


CopyBits 


function 


quickdraw 


DialogTHndl 


type 


dialogs 


CopyRgn 


function 


quickdraw 


DialogTPtr 


type 


dialogs 


copysign 


function 


sane 


diamondMark 


define 


fonts 


cos 


function 


sane 


DIBadMount 


function 


packages 


cos 


function 


trig(C) 


DiffRgn 


function 


quickdraw 


cosh 


function 


cosh(C) 


D I Format 


function 


packages 


CouldAlert 


function 


dialogs 


D I Load 


function 


packages 


CouldDialog 


function 


dialogs 


dIristErr 


define 


devices 


CountAppFiles 


function 


segload 


dirFulErr 


define 


files 


CountMItems 


function 


menus 


Disableltem 


function 


menus 


CountResources 


function 


resources 


DiskEject 


function 


disks 


CountTypes 


function 


resources 


diskEvt 


define 


event s 


courier 


define 


fonts 


diskMask 


define 


event s 


creat 


function 


creat (C) 


di spent 1 


define 


controls 


Create 


function 


files 


DisposDialog 


function 


dialogs 


CreateResFile 


function 


resources 


DisposeControl 


function 


controls 


crossCursor 


define 


toolutils 


DisposeMenu 


function 


menus 


ctnlcon 


define 


dialogs 


DisposeRgn 


function 


quickdraw 


ctrlltem 


define 


dialogs 


DisposeWindow 


function 


windows 


ctsEvent 


define 


serial 


DisposHandle 


function 


memory 


CurResFile 


function 


resources 


DisposPtr 


function 


memory 


currLeadingZ 


define 


packages 


DIUnLoad 


function 


packages 


currNegSym 


define 


packages 


DIVBYZERO 


define 


sane 


currSymLead 


define 


packages 


DIVerify 


function 


packages 


currTrailingZ 


define 


packages 


DIZero 


function 


packages 


CursHandle 


type 


toolutils 


DlgCopy 


function 


dialogs 


Cursor 


type 


quickdraw 


DlgCut 


function 


dialogs 


Cursor 


type 


toolutils 


DlgDelete 


function 


dialogs 


CursPtr 


type 


toolutils 


DlgPaste 


function 


dialogs 


cyanBit 


define 


quickdraw 


dmy 


define 


packages 


cyanColor 


define 


quickdraw 


documentProc 


define 


windows 


dataS 


define 


serial 


DOWNWARD 


define 


sane 


data 6 


define 


serial 


dragCntl 


define 


controls 


data 7 


define 


serial 


DragControl 


function 


controls 


data 8 


define 


serial 


DragGrayRgn 


function 


windows 
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DragWindow 

DrawChar 

drawCntl 

DrawControls 

DrawDialog 

DrawGrowIcon 

DrawMenuBar 

DrawNew 

DrawPicture 

Drawstring 

DrawText 

dRemoveErr 

driverEvt 

driverMask 

DriveStatus 

DrvQEl 

DrvQElPtr 

drvQType 

DrvSts 

dsAddressErr 

dsBadLaunch 

dsBusErr 

dsChkErr 

dsCoreErr 

dsFPErr 

dsFSErr 

dsIllInstErr 

dsIOCoreErr 

dsIrqErr 

dskFulErr 

dsklnit 

dsLineAErr 

dsLineFErr 

dsLoadErr 

dsMemFullErr 

dsMiscErr 

dsNoPackErr 

dsNoPkl 

dsNoPk2 

dsNoPk3 

dsNoPk4 

dsNoPkS 

dsNoPke 

dsNoPk? 

dsNotThel 

dsOvf lowErr 

dsPrivErr 

dsReinsert 

dsStkNHeap 

dsSysErr 

dsTraceErr 

dsZeroDivErr 

dummyType 

dupFNErr 

EACCESS 

EBADF 

ecvt 

edit Text 

EEXIST 

EINVAL 

EIO 

EISDIR 

Eject 



function 

function 

define 

function 

function 

function 

function 

function 

function 

function 

function 

define 

define 

define 

function 

type 

type 

literal 

type 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

literal 

define 

define 

define 

function 

define 

define 

define 

define 

define 

function 



windows 

quickdraw 

controls 

controls 

dialogs 

windows 

menus 

windows 

quickdraw 

quickdraw 

quickdraw 

devices 

events 

events 

disks 

files 

files 

osutils 

disks 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

files 

packages 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

error 

osutils 

files 

Error Numbers (C) 

Error Numbers (C) 

ecvt (C) 

dialogs 

Error Numbers (C) 

Error Numbers (C) 

Error Numbers (C) 

Error Numbers (C) 

files 



EMFILE 

EmptyHandle 

EmptyRect 

Empty Rgn 

Enableltem 

EndUpdate 

ENFILE 

ENODEV 

ENOENT 

ENOMEM 

ENOSPC 

ENOTDIR 

Enqueue 

environment 

Environs 

ENXIO 

EOF 

eofErr 

EPERM 

EqualPt 

EqualRect 

EqualRgn 

EqualString 

EQUALTO 

erase 

EraseArc 

EraseOval 

ErasePoly 

EraseRect 

EraseRgn 

EraseRoundRect 

EROFS 

ErrorSound 

ESPIPE 

evenParity 

EventAvail 

EventRecord 

everyEvent 

EvQEl 

evType 

exception 

exit 

_exit 

ExitToShell 

exp 

exp 

expl 

exp2 

expand 

extFSErr 

EXTPRECISION 

fabs 

f abs 

false 

fBsyErr 

fclose 

fcvt 

fDesktop 

fDisk 

fdopen 

feedCut 

feedFanfold 

feedMechCut 



define 

function 

function 

function 

function 

function 

define 

define 

define 

define 

define 

define 

function 

type 

function 

define 

define 

define 

define 

function 

function 

function 

function 

define 

literal 

function 

function 

function 

function 

function 

function 

define 

function 

define 

define 

function 

type 

define 

type 

literal 

type 

function 

function 

function 

function 

function 

function 

function 

define 

define 

define 

function 

function 

literal 

define 

function 

function 

define 

define 

function 

literal 

literal 

literal 



Error Numbers (C) 
memory 
quickdraw 
quickdraw 
menus 
windows 

Error Numbers (C) 
Error Numbers (C) 
Error Numbers (C) 
Error Numbers (C) 
Error Numbers (C) 
Error Numbers (C) 
osutils 
sane 
osutils 

Error Numbers (C) 
stdio(C) 
files 

Error Numbers (C) 
quickdraw 
quickdraw 
quickdraw 
osutils 
sane 

quickdraw 
quickdraw 
quickdraw 
quickdraw 
quickdraw 
quickdraw 
quickdraw 
Error Numbers (C) 
dialogs 

Error Numbers (C) 
serial 
events 
events 
■ events 
osevents 
osutils 
sane 
exit (C) 
exit (C) 
segload 
exp(C) 
sane 
sane 
sane 

quickdraw 
files 
sane 
floor (C) 
sane 
types 
files 
fclose (C) 
ecvt (C) 
files 
files 
fopen (C) 
printing 
printing 
printing 
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feedOther 

feof 

ferror 

fflush 

ffMode 

FFSynthPtr 

FFSynthRec 

fgetc 

fgets 

fHasBundle 

FILE 

fileno 

FileParam 

fill 

FillArc 

FillOval 

FillPoly 

FillRect 

FillRgn 

FillRoundRect 

FindControl 

FindWindow 

FInfo 

FInitQueue 

finvisible 

firstDskErr 

Fixed 

FIXEDDECIMAL 

fixedFont 

FixMul 

FixRatio 

FixRound 

FlashMenuBar 

fLckdErr 

FLOATDECIMAL 

FLOATPRECISION 

floor 

flPoint 

FlushEvents 

FlushVol 

FMInput 

fmod 

FMOutPtr 

FMOutput 

fnfErr 

fnOpnErr 

Fontlnfo 

FontRec 

fontWid 

fopen 

ForeColor 

f print f 

fputc 

fputs 

frame 

Frame Arc 

FrameOval 

FramePoly 

FrameRect 

FrameRgn 

FrameRoundRect 

framingErr 

fread 



literal 

macro 

macro 

function 

define 

type 

type 

function 

function 

define 

define 

macro 

type 

literal 

function 

function 

function 

function 

function 

function 

function 

function 

type 

function 

define 

define 

type 

define 

define 

function 

function 

function 

function 

define 

define 

define 

function 

define 

function 

function 

type 

function 

type 

type 

define 

define 

type 

type 

define 

function 

function 

function 

function 

function 

literal 

function 

function 

function 

function 

function 

function 

define 

function 



printing 

ferror (C) 

ferror (C) 

f close (C) 

sound 

sound 

sound 

getc(C) 

gets (C) 

files 

stdio(C) 

ferror (C) 

files 

quickdraw 

quickdraw 

quickdraw 

quickdraw 

quickdraw 

quickdraw 

quickdraw 

controls 

windows 

files 

files 

files 

disks 

types 

sane 

fonts 

toolutils 

toolutils 

toolutils 

menus 

files 

sane 

sane 

floor (C) 

packages 

osevents 

files 

fonts 

floor (C) 

fonts 

fonts 

files 

files 

quickdraw 

fonts 

fonts 

fopen (C) 

quickdraw 

printf (C) 

putc(C) 

puts(C) 

quickdraw 

quickdraw 

quickdraw 

quickdraw 

quickdraw 

quickdraw 

quickdraw 

serial 

fread (C) 



free 

FreeAlert 

FreeDialog 

FreeMem 

FreeWave 

freopen 

frexp 

FrontWindow 

fsAtMark 

f scanf 

FSClose 

f sCurPerm 

FSDelete 

f seek 

fsFromLEOF 

f sFromMark 

fsFromStart 

FSOpen 

fsQType 

f sRdPerm 

fsRdWrPerm 

FSRead 

fsRnErr 

FSWrite 

f sWrPerm 

ftell 

ftMode 

fTrash 

FTSndRecPtr 

FTSoundRec 

FTSynthPtr 

FTSynthRec 

fwrite 

geneva 

GetAlrtStage 

GetAppFiles 

Get Appl Limit 

GetAppParms 

getc 

getCancel 

GetCaretTime 

getchar 

Getc lip 

GetCRefCon 

GetCTitle 

GetCtlAction 

GetCtlMax 

GetCtlMin 

GetCt lvalue 

GetCursor 

GetDateTime 

GetDblTime 

GetDCtlEntry 

GetDItem 

getDlgID 

get Drive 

GetDrvQHdr 

getE ject 

getenvironment 

GetEOF 

GetEvQHdr 

GetFInfo 

GetFNum 



function 

function 

function 

function 

type 

function 

function 

function 

define 

function 

function 

define 

function 

function 

define 

define 

define 

function 

literal 

define 

define 

function 

define 

function 

define 

function 

define 

define 

type 

type 

type 

type 

function 

define 

function 

function 

function 

function 

macro 

define 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

define 

define 

function 

define 

function 

function 

function 

function 

function 



malloc (C) 

dialogs 

dialogs 

memory 

sound 

fopen (C) 

frexp (C) 

windows 

files 

scanf (C) 

files 

files 

files 

fseek(C) 

files 

files 

files 

files 

osutils 

files 

files 

files 

files 

files 

files 

fseek(C) 

sound 

files 

sound 

sound 

sound 

sound 

fread (C) 

fonts 

dialogs 

segload 

memory 

segload 

getc(C) 

packages 

events 

getc(C) 

quickdraw 

controls 

controls 

controls 

controls 

controls 

controls 

toolutils 

osutils 

events 

devices 

dialogs 

packages 

packages 

files 

packages 

sane 

files 

osevents 

files 

fonts 
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GetFontlnfo 

GetFontName 

GetFPos 

GetFSQHdr 

get halt vector 

GetHandleSize 

Getlcon 

GetlndPattern 

GetlndResource 

GetlndString 

GetlndType 

Getltem 

Getltemlcon 

GetltemMark 

GetltemStyle 

Get I Text 

GetKeys 

GetMenu 

GetMenuBar 

GetMHandle 

GetMouse 



function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 
function 



GetNamedRes our cef unction 

GetNewControl function 

GetNewDialog 

GetNewMBar 

GetNewWindow 

GetNextEvent 

getNmList 



get Open 

GetOSEvent 

GetPattern 

GetPen 

GetPenState 

GetPicture 

GetPixel 

GetPort 

getprecsion 

GetPtrSize 

GetResAttrs 



function 

function 

function 

function 

define 

define 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 



GetResFileAttrs function 



GetResInfo 

GetResource 

getround 

gets 

GetScrap 

getScroll 

GetSoundVol 

GetString 

GetSysPPtr 

GetTime 

GetTrapAddress 

GetVBLQHdr 

GetVCBQHdr 

GetVInfo 

GetVol 

GetVRefNum 

getw 

GetWindowPic 

Get WMgr Port 

GetWRefCon 

GetWTitle 

GetZone 

GlobalToLocal 



function 

function 

function 

function 

function 

define 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 



quickdraw 

fonts 

files 

files 

sane 

memory 

toolutils 

toolutils 

resources 

toolutils 

resources 

menus 

menus 

menus 

menus 

dialogs 

events 

menus 

menus 

menus 

events 

resources 

controls 

dialogs 

menus 

windows 

events 

packages 

packages 

osevents 

toolutils 

quickdraw 

quickdraw 

toolutils 

quickdraw 

quickdraw 

sane 

memory 

resources 

resources 

resources 

resources 

sane 

gets (C) 

scrap 

packages 

sound 

toolutils 

osutils 

osutils 

osutils 

retrace 

files 

files 

files" 

files 

getc(C) 

windows 

windows 

windows 

windows 

memory 

quickdraw 



GrafDevice 

GrafPort 

GrafPtr 

GrafVerb 

GREATERTHAN 

greenBit 

greenColor 

GrowWindow 

GZCritical 

GZSaveHnd 

haltvector 

HandAndHand 

Handle 

HandleZone 

HandToHand 

hAxisOnly 

hAxisOnly 

helvetica 

HideControl 

HideCursor 

HidePen 

HideWindow 

HiliteControl 

HiliteMenu 

HiliteWindow 

HiWord 

HLock 

HNoPurge 

HomeResFile 

HPurge 

hrLeadingZ 

HUnlock 

hwOverrunErr 

hypot 

iBeamCursor 

iconltem 

ilOAbort 

iMemFullErr 

inButton 

inCheckbox 

inContent 

inDesk 

inDownButton 

inDrag 

INEXACT 

inf 

INFINITE 

InfoScrap 

inGoAway 

inGrow 

InitAllPacks 

InitApplZone 

initCntl 

InitCursor 

InitDialogs 

InitFonts 

InitGraf 

initlWMErr 

InitMenus 

InitPack 

InitPort 

InitResources 

InitUtil 



function 

type 

type 

type 

define 

define 

define 

function 

function 

function 

type 

function 

type 

function 

function 

define 

define 

define 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

function 

define 

function 

define 

function 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

define 

function 

define 

function 

define 

define 

function 

function 

define 

function 

function 

function 

function 

define 

function 

function 

function 

function 

function 



quickdraw 

quickdraw 

quickdraw 

quickdraw 

sane 

quickdraw 

quickdraw 

windows 

memory 

memory 

sane 

osutils 

types 
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